Append an agent step

Records one step in an agent loop. Server computes a SHA-256 fingerprint of tool_name + tool_input for loop detection and bumps the agent_tools registry when tool_name is present.

Authorization

ApiKeyAuth

Authorization<token>

Format: "Bearer kw_"

In: header

Request Body

application/json

Step payload

TypeScript Definitions

Use the request body type in TypeScript.

agent_run_id*string

content?string

Lengthlength <= 100000

cost_usd?number

Range0 <= value

metadata?

step_index?integer

Range0 <= value

step_type*string

Value in

"think"
"tool_call"
"tool_result"
"replan"

timestamp?string

tokens?integer

Range0 <= value

tool_input?

tool_latency_ms?integer

Range0 <= value

tool_name?string

Lengthlength <= 200

tool_output?

tool_success?boolean

Response Body

`application/json`

curl -X POST "https://example.com/ingest/agent/steps" \  -H "Content-Type: application/json" \  -d '{    "agent_run_id": "string",    "step_type": "think"  }'

{  "id": "string",  "timestamp": "string"}

Append an agent step

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`