Attest how a finished check report was consumed

Call after a finished owned check, while the same credential is still valid. Idempotency-Key is required. decision is a client-attested CONTINUE, UPDATE_INTEGRATION, or HOLD value; Exactlane does not derive it from the report and there is no universal verdict-to-decision mapping. report_consumed is a required boolean. trigger must be one of NEW_WORK, DEPENDENCY_CHANGE, REQUIREMENTS_CHANGE, INTEGRATION_FAILURE, OTHER_REAL_WORK. MCP check_mcp_capability never creates this event (usage_event_created is false).

post/v0/usage-events

Request

  • Base URL: https://exactlane.dev (the document declares no server; this is the origin it was published from)
  • URL: https://exactlane.dev/v0/usage-events
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Required on POST /v0/agents, POST /v0/capabilities, POST /v0/checks, POST /v0/revision-checks, and POST /v0/usage-events. 8 to 128 visible ASCII characters without spaces. Same key plus same body replays; same key plus a changed body returns 409.

Request body

autonomousboolean required
check_run_idstring required

Owned finished check run id from POST /v0/checks or GET /v0/checks/{run_id}

decision'CONTINUE' | 'UPDATE_INTEGRATION' | 'HOLD' required

Client-attested operational decision supplied by the caller. Exactlane produces compatibility evidence; the caller owns the operational decision. Exactlane validates and records this value but does not derive it from the report, and there is no universal verdict-to-decision mapping.

integration_refstring required

Opaque caller integration identifier (letters, digits, dot, underscore, colon, hyphen)

is_demoboolean required
is_health_checkboolean required
is_retryboolean required
occurred_atstring date-time required

RFC3339 timestamp. Must not be more than five minutes in the future or older than 45 days.

platform_triggeredboolean required
report_consumedboolean required

Required caller attestation that the finished report was consumed. Exactlane does not infer this from the check.

trigger'NEW_WORK' | 'DEPENDENCY_CHANGE' | 'REQUIREMENTS_CHANGE' | 'INTEGRATION_FAILURE' | 'OTHER_REAL_WORK' required

Client-attested real-work category. Public values: NEW_WORK, DEPENDENCY_CHANGE, REQUIREMENTS_CHANGE, INTEGRATION_FAILURE, OTHER_REAL_WORK. Other strings return 422 INVALID_TRIGGER.

workflow_refstring required

Opaque caller workflow identifier (letters, digits, dot, underscore, colon, hyphen). Unique with integration_ref per principal; a second distinct body returns 409 DUPLICATE_WORKFLOW_EVENT.

Response

Client-attested usage event

usage_eventobject required

Changes

No recorded changes to this operation across all 1 revision of this API.