write

Update an agent job

Update a running agent job the current team owns: progress {done,total}, append a step line, set status (running|done|failed), record createdPostIds, an error, or usage {inputTokens,outputTokens,model?} — the tokens spent since the previous update (deltas, added to the job totals and priced in USD). Bumps heartbeat.

post/api/v1/update_agent_job

Request

  • Base URL: https://awraiter.ai
  • URL: https://awraiter.ai/api/v1/update_agent_job
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry key (≤ 200 characters). A repeated call with the same key returns the first call's result instead of acting twice. Without it the server hashes the arguments, which catches retries but treats a deliberate repeat within 24 hours as one too.

Request body

jobIdnumber required
appendStepstring
status'running' | 'done' | 'failed'
createdPostIdsnumber[]
errorstring

Response

The tool's result in data.

okunknown required
dataobject required

Not declared by the tool yet; treat the shape as informational.

Changes

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