keelwave
API ReferenceIngest

Start an agent run

POST
/ingest/agent/runs

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"}