Skip to main content
POST
Import a receipt

Authorizations

Authorization
string
header
required

OrgX API key, sent as Authorization: Bearer oxk_...

Headers

Idempotency-Key
string
required

Workspace-scoped retry key for safe mutation replay.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$

Body

application/json
receipt
Agent Work Receipt v0.1 · object
required

A portable, account-free record of agent intent, authority, actions, evidence, outcome, verification, cost, lineage, and human intervention. Identifiers are opaque external strings and never require an OrgX account or UUID.

workspace_id
string<uuid>

Existing OrgX workspace the authenticated caller can access

idempotency_key
string
deprecated

Compatibility field. New integrations send the Idempotency-Key header.

Required string length: 1 - 160
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,159}$

Response

Idempotent retry returned the existing hosted receipt

ok
boolean
required
receipt_id
string<uuid>
required

OrgX-hosted receipt identifier

external_receipt_id
string
required

Producer-owned portable receipt identifier

schema_version
string
required
Allowed value: "agent-work-receipt/v0.1"
idempotent
boolean
required
imported_at
string<date-time>
pilot
null | object