curl --request POST \
--url https://api.conduit.ai/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservations",
"description": "Handles booking and cancellation flows.",
"instructions": "Answer booking questions, use policies before escalating, and keep replies concise.",
"guardrails": [
{
"title": "Do not promise refunds",
"knowledge": "Only cite refund terms from approved policy docs or escalate."
}
],
"skill_ids": [
"ks77c0dy0mgdpzmqz6tesry8w184002s"
],
"operation_mode": "autopilot",
"response_language": "English",
"responseflow": true,
"custom_response_delay_ms": 10000,
"auto_mark_as_done": false,
"output_schema": [
{
"name": "resolution",
"description": "Short summary of the final outcome.",
"type": "string",
"is_required": true
}
],
"triggers": [
{
"name": "Reservation Inbox",
"description": "Runs for reservation inbox messages.",
"type": "message",
"config": {
"inboxTypeId": "guest",
"channels": [
"unthreaded_email"
]
},
"enabled": true
}
]
}
'{
"data": {
"id": "ag77c0dy0mgdpzmqz6tesry8w184002s",
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservations",
"description": "Handles booking and cancellation flows.",
"version": "v2",
"instructions": "Answer booking questions, use policies before escalating, and keep replies concise.",
"guardrails": [
{
"id": "guardrail_1",
"title": "Do not promise refunds",
"knowledge": "Only cite refund terms from approved policy docs or escalate."
}
],
"operation_mode": "autopilot",
"autopilot_schedule": null,
"custom_response_delay_ms": 10000,
"auto_mark_as_done": false,
"response_language": "English",
"responseflow": true,
"output_schema": [
{
"name": "resolution",
"description": "Short summary of the final outcome.",
"type": "string",
"is_required": true
}
],
"skill_ids": [
"ks77c0dy0mgdpzmqz6tesry8w184002s"
],
"enabled": true,
"triggers": [
{
"id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservation Inbox",
"description": "Runs for reservation inbox messages.",
"type": "message",
"config": {
"inboxTypeId": "guest",
"channels": [
"unthreaded_email"
]
},
"enabled": true,
"created_at": "2026-04-01T17:22:10.000Z",
"updated_at": "2026-04-03T03:14:15.000Z"
}
],
"created_at": "2026-04-01T17:22:10.000Z",
"updated_at": "2026-04-03T03:14:15.000Z"
}
}Creates a V2 chat agent and its initial trigger set. Requires a token with write access.
curl --request POST \
--url https://api.conduit.ai/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservations",
"description": "Handles booking and cancellation flows.",
"instructions": "Answer booking questions, use policies before escalating, and keep replies concise.",
"guardrails": [
{
"title": "Do not promise refunds",
"knowledge": "Only cite refund terms from approved policy docs or escalate."
}
],
"skill_ids": [
"ks77c0dy0mgdpzmqz6tesry8w184002s"
],
"operation_mode": "autopilot",
"response_language": "English",
"responseflow": true,
"custom_response_delay_ms": 10000,
"auto_mark_as_done": false,
"output_schema": [
{
"name": "resolution",
"description": "Short summary of the final outcome.",
"type": "string",
"is_required": true
}
],
"triggers": [
{
"name": "Reservation Inbox",
"description": "Runs for reservation inbox messages.",
"type": "message",
"config": {
"inboxTypeId": "guest",
"channels": [
"unthreaded_email"
]
},
"enabled": true
}
]
}
'{
"data": {
"id": "ag77c0dy0mgdpzmqz6tesry8w184002s",
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservations",
"description": "Handles booking and cancellation flows.",
"version": "v2",
"instructions": "Answer booking questions, use policies before escalating, and keep replies concise.",
"guardrails": [
{
"id": "guardrail_1",
"title": "Do not promise refunds",
"knowledge": "Only cite refund terms from approved policy docs or escalate."
}
],
"operation_mode": "autopilot",
"autopilot_schedule": null,
"custom_response_delay_ms": 10000,
"auto_mark_as_done": false,
"response_language": "English",
"responseflow": true,
"output_schema": [
{
"name": "resolution",
"description": "Short summary of the final outcome.",
"type": "string",
"is_required": true
}
],
"skill_ids": [
"ks77c0dy0mgdpzmqz6tesry8w184002s"
],
"enabled": true,
"triggers": [
{
"id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"name": "Reservation Inbox",
"description": "Runs for reservation inbox messages.",
"type": "message",
"config": {
"inboxTypeId": "guest",
"channels": [
"unthreaded_email"
]
},
"enabled": true,
"created_at": "2026-04-01T17:22:10.000Z",
"updated_at": "2026-04-03T03:14:15.000Z"
}
],
"created_at": "2026-04-01T17:22:10.000Z",
"updated_at": "2026-04-03T03:14:15.000Z"
}
}Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.
Request body for creating a V2 chat agent with one or more triggers.
11Show child attributes
11Show child attributes
autopilot, copilot, inactive x >= 0English, Original, Spanish, French, German, Italian, Portuguese Show child attributes
Agent created
Single V2 chat agent response.
Show child attributes
Was this page helpful?