Skip to main content
POST
/
v1
/
agents
/
{id}
/
run
Run V2 chat agent
curl --request POST \
  --url https://api.conduit.ai/v1/agents/{id}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trigger_id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
  "payload": {
    "reservation_id": "res_123",
    "status": "confirmed"
  }
}
'
{
  "data": {
    "dispatched": true,
    "trigger_id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
    "trigger_type": "event"
  }
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

Agent id.

Example:

"ag77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

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

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Body

application/json

Request body for manually dispatching a V2 chat agent.

​
trigger_id
string

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

Example:

"tr77c0dy0mgdpzmqz6tesry8w184002s"

​
payload
any | null

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.

Response

Agent dispatched

Result of a manual agent dispatch.

​
data
object
required