Skip to main content
POST
/
v1
/
agents
Create V2 chat agent
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"
  }
}

Authorizations

Authorization
string
header
required

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

Body

application/json

Request body for creating a V2 chat agent with one or more triggers.

workspace_id
string
required
name
string
required
Minimum string length: 1
triggers
object[]
required
Minimum array length: 1
description
string
Minimum string length: 1
instructions
string
Minimum string length: 1
guardrails
object[]
skill_ids
string[]
operation_mode
enum<string>
Available options:
autopilot,
copilot,
inactive
autopilot_schedule
unknown
custom_response_delay_ms
integer
Required range: x >= 0
auto_mark_as_done
boolean
response_language
enum<string> | null
Available options:
English,
Original,
Spanish,
French,
German,
Italian,
Portuguese
responseflow
boolean
output_schema
object[]
enabled
boolean

Response

Agent created

Single V2 chat agent response.

data
object
required