5a5597ebb2d6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-126178842.7 MB

assistants

Update stable identity (name, description, metadata, voice concurrency cap)

In-place identity update — no run semantics (§3.3).

Also the write path for max_active_calls, the per-agent voice concurrency cap (Layer 2c) — a top-level Agent column, so it does not belong on a revision PATCH. Passing model_fields_set through is what makes the cap's tri-state work: omitted leaves it alone, explicit null clears it. A cap that exceeds the org's active-call cap is rejected 422 by the service (the org cap is the hard ceiling on every admit, so a higher per-agent cap is unreachable).

patch/v1/assistants/{agent_id}

Path parameters

agent_idstring uuid required

Request body

namestring nullable

descriptionstring nullable

metadataobject nullable

max_active_callsinteger nullable

Response

Successful Response

idstring uuid required

organization_idstring uuid required

namestring required

descriptionstring nullable

active_revision_idstring uuid nullable

metadataobject

platform_toolsobject

knowledge_gap_analysis_enabledboolean

release_suite_idstring uuid nullable

release_gate_mode'off' | 'advisory'

Per-agent release-gate mode (ENG-727). off = no release checks; advisory = compute + display a verdict but never block activation. The gate always runs and surfaces a verdict; it never refuses activation.

release_gate_max_failuresinteger

max_active_callsinteger nullable

created_atstring date-time required

updated_atstring date-time required