Skip to main content
POST
Complete an agent run

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Path Parameters

id
string<uuid>
required

Agent run id.

Body

application/json
status
enum<string>
default:completed
Available options:
completed,
failed,
cancelled,
blocked
summary
string
Maximum string length: 4000
error
string
Maximum string length: 4000
spend
object
token_usage
object
metadata
object
debrief
object

Run-end learnings flowed back into memory automatically.

Response

Run completed.

run
object
required

Serialised agent run (contracts/brain-ops.ts formatRun).

consolidation
object | null
required

Present only when a debrief was supplied and consolidation succeeded; null otherwise (consolidation failure is non-fatal).