Announce an agent run under a mandate

POST/v1/operators/{agentId}/mandates/{mandateId}/runs

Tells the mandate's owner that the operator's agent started or ended shopping under the mandate, with the live view of its browser, as an agent.run event on the owner's mandate:<id> stream. Only the OAuth client that linked the operator announces runs, on its active mandates.

Path parameters

agentIdstringRequired: The ERC-8004 agent id, a decimal integer.
mandateIdstringRequired

Headers

Content-Typeapplication/jsonRequired
idempotency-keystringRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Request body

application/json

statestringRequired: One of startedended
liveViewUrlstring: Kernel's live view of the agent's browser, opened read-only.

Responses

202Published to the mandate's owner
401No valid access token
403The token lacks countersign:write
404No active mandate of an operator this client linked
422Invalid, or not a Kernel live view

202 response

curl -X POST https://api.keelson.finance/v1/operators/{agentId}/mandates/{mandateId}/runs \
  -H 'content-type: application/json' \
  -H 'idempotency-key: <idempotency-key>' \
  -H "idempotency-key: $(uuidgen)" \
  --data '{"state":"started","liveViewUrl":"string"}'

const res = await fetch("https://api.keelson.finance/v1/operators/{agentId}/mandates/{mandateId}/runs", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "idempotency-key": "<idempotency-key>",
    "idempotency-key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "state": "started",
    "liveViewUrl": "string"
  }),
});
const data = await res.json();