Developers
Build with the API

Agents

Dispatch Theo Agents and monitor their runs.

Dispatching

Dispatch any of your Theo Agents by id (requires the ai scope). The dispatch returns 202with the new run's identifiers; execution continues in the background through the same engine that powers manual runs in-app, including credit accounting and run history.

POST/agents/{id}/run
curl
curl -X POST https://www.opencharts.com/api/v1/agents/AGENT_ID/run \
  -H "Authorization: Bearer $OPENCHARTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inputs": { "topic": "Weekly metrics recap" } }'

Monitoring runs

Poll a run until it reaches a terminal state, or list an agent's recent history. Pair with the evi.run_completed / evi.run_failed webhook events to skip polling.

GET/agents/{id}/runsGET/agents/{id}/runs/{runId}