AI agents

Start an agent

Queues a run of one of this organisation’s agents and returns a run id — it does NOT wait for the result, because a run makes several model calls and can take minutes. The agent runs with ITS OWN permissions and its own tool list, not yours, so it can do exactly what it was configured to do and nothing more. Confirm with the user before starting one: a run costs money and may send mail or change records, depending on how it was set up.

post/api/v1/rest/agenti/{id}/runs

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/agenti/{id}/runs
  • Auth: HTTP bearer

Path parameters

idstring uuid required

From agenti_list.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

taskstring

What this particular run should deal with, in your own words. Omit to let the agent follow its standing instructions.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.