API ReferenceIngest
Start an agent run
Opens a new agent run record with status="running". Returns id + timestamp; the client must pass both back to finish the run.
Authorization
ApiKeyAuth Authorization<token>
Format: "Bearer kw_"
In: header
Request Body
application/json
Run start payload
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/ingest/agent/runs" \ -H "Content-Type: application/json" \ -d '{ "agent_name": "string" }'{ "id": "string", "timestamp": "string"}