Messages and runs

A run is one execution of an agent. These three tools are how you test an agent without first inventing a routine for it, and how you find out why the answer was not what you expected.

send_message

Talks to an agent and waits for its answer.

string

required

string

required

string

Continue an earlier conversation. Omit to start a new one.

number

How long to wait for the answer. Default 120, maximum 600.

If the agent is still working when the wait runs out, the call returns status: "running" with a runId, a note, and the run carries on in the background. Poll get_run for the result.

Response

{
  "runId": "…",
  "status": "done",
  "sessionId": "…",
  "provider": "anthropic",
  "model": "claude-sonnet-5",
  "trigger": "api",
  "steps": 7,
  "inputTokens": 18422,
  "outputTokens": 913,
  "totalTokens": 19335,
  "costUsd": 0.0741,
  "startedAt": "2026-08-15T09:12:04.000Z",
  "finishedAt": "2026-08-15T09:12:41.000Z",
  "error": null,
  "output": "Done. I added 14 rows to the leads table and flagged 3 duplicates."
}

An agent can pause mid-run to ask you something or request an approval. When that happens the run finishes with the question waiting in the app, and output carries the agent last message. See Human in the loop.

list_runs

Recent executions of an agent, newest first.

string

required

number

Default 20, maximum 200.

Each run carries the same fields as the response above, without output. Use it to see whether a scheduled task or a webhook actually did anything. The trigger field tells you where the run came from: chat, api, schedule:<slug> or trigger:<slug>.

get_run

One execution in full.

string

required

string

required

boolean

Also return every tool the agent called, with its input and its result.

Response with includeToolCalls

{
  "runId": "…",
  "status": "error",
  "error": "Connector notion is not connected",
  "output": null,
  "toolCalls": [
    {
      "step": 1,
      "tool": "memory_recall",
      "input": "{\"query\":\"weekly report format\"}",
      "result": "{\"memories\":[…]}",
      "isError": false,
      "durationMs": 82
    }
  ]
}

Run statuses are running, done, error and cancelled. costUsd is the model cost of that run, and is null while it is still running.

Get started

Tool reference

HTTP

Messages and runs

send_message

list_runs

get_run

​send_message

​list_runs

​get_run

send_message

list_runs

get_run