Skip to main content
POST
Complete work with evidence

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}$

Path Parameters

taskId
string<uuid>
required

Work item to complete

Body

application/json

Send version_token, or send both expected_updated_at and expected_aggregate_version during the compatibility window. If both forms are present they must describe the same version.

version_token
string
required

Preferred concurrency input. Copy data.concurrency.version_token from GET /work/{taskId} without changing it.

Minimum string length: 1
expected_updated_at
string<date-time>
expected_aggregate_version
integer
Required range: x >= 0
summary
string | null
Maximum string length: 4000
evidence
object
cost_cents
integer
default:0
Required range: x >= 0
causation_id
string<uuid> | null
correlation_id
string<uuid> | null

Response

Idempotent replay of the same command

data
object
required
meta
object
required