Finish an agent run

Marks a run terminal and writes totals. timestamp must match the value returned at start (hypertable PK).

Authorization

ApiKeyAuth

Authorization<token>

Format: "Bearer kw_"

In: header

Path Parameters

runID*string

Agent run UUID

Request Body

application/json

Run finish payload

TypeScript Definitions

Use the request body type in TypeScript.

duration_ms?integer

Range0 <= value

loop_detected?boolean

loop_step_index?integer

Range0 <= value

output?string

Lengthlength <= 100000

status*string

Value in

"completed"
"failed"

termination_reason?string

Value in

"clean"
"max_steps_reached"
"context_limit"
"error"
"loop_detected"
"timeout"

timestamp*string

total_cost_usd?number

Range0 <= value

total_steps?integer

Range0 <= value

total_tokens?integer

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/ingest/agent/runs/string/finish" \  -H "Content-Type: application/json" \  -d '{    "status": "completed",    "timestamp": "string"  }'

Empty

Finish an agent run

Authorization

Path Parameters

Request Body

Response Body

204

400application/json

401application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`