Skip to main content
POST
Run V2 chat agent

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