Record an agent action

Authentication

AuthorizationBearer

Organization-scoped API key.

Headers

X-API-VersionstringRequired
Idempotency-KeystringRequired

Idempotency key; duplicate submissions return the original event.

Request

This endpoint expects an object.
descriptionstringRequired>=1 character
What the agent did
projectNamestringRequired>=1 character
taskIdstringRequired

Target task — create one via POST /tasks first

addAttachmentslist of objectsOptional

Files to attach to the task — upload id + display name (each id from POST /uploads)

detailmap from strings to anyOptional
externalTraceIdstringOptional
metadataPatchobjectOptional
transitionsTostringOptional

State to transition the task into; must be a declared transition

Response

Created