Skip to main content
PATCH
Patch 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 patching a V2 chat agent. skill_ids and triggers replace the existing values when provided.

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

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 | null
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[] | null
enabled
boolean
triggers
object[]

Response

Agent updated

Single V2 chat agent response.

data
object
required