Skip to main content
POST
Create V2 chat agent

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
color
string
Minimum string length: 1
icon_id
integer
Required range: x >= 0
instructions
string
Minimum string length: 1
model
string | null

Override the LLM this agent runs on. Must be a model_string from GET /v1/models (MCP: list_supported_models), e.g. openai:gpt-4o. Omit to leave unchanged; send null to reset to the workspace default. Reads return the configured value, or default when none is set.

Minimum string length: 1
guardrails
object[]
skill_ids
string[]
operation_mode
enum<string>
Available options:
autopilot,
copilot,
inactive
autopilot_schedule
object

Autopilot schedule. Autopilot only sends inside the enabled day windows; outside them the agent falls back to copilot. Omit or set null for always-on autopilot.

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