v1

latestOpenAPI 3.0.02026-07-26870415.2 KB

agents

Run V2 chat agent

Manually dispatches a V2 agent as if one of its triggers fired. Cron triggers run immediately; webhook and workflow triggers use the supplied payload. Channel/message triggers are not supported. Requires a token with write access.

post/v1/agents/{id}/run

Path parameters

idstring required

Agent id.

Example:ag77c0dy0mgdpzmqz6tesry8w184002s

Query parameters

workspace_idstring

Optional workspace override. If omitted, Conduit resolves the agent's workspace automatically.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Request body

trigger_idstring

Which trigger to run. Required only when the agent has more than one trigger. Cron runs immediately; webhook and workflow runs use payload.

{"stackTrail":"paths:/v1/agents/{id}/run:post:requestBody:content:application/json:schema:properties:payload","oasType":"schema","type":"unknown","description":"Event payload for webhook / workflow triggers — the same JSON shape that trigger would receive when it fires for real. Ignored for cron triggers. Defaults to an empty object.","nullable":true}

Example request

{
  "trigger_id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
  "payload": {
    "reservation_id": "res_123",
    "status": "confirmed"
  }
}

Response

Agent dispatched

Example response

{
  "data": {
    "dispatched": true,
    "trigger_id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
    "trigger_type": "event"
  }
}