Skip to main content
PATCH
Update revision config (any revision, in place)

Authorizations

x-api-key
string
header
required

Path Parameters

agent_id
string<uuid>
required
revision_id
string<uuid>
required

Body

application/json

Request body for PATCH /assistants/{id}/revisions/{rid} — edit any revision.

A subset of the behavioral fields that live on AgentRevision. base_version is the optimistic-concurrency version of the revision. If supplied, the revision's version column must match; a mismatch raises ConflictError (409).

extra=forbid: unknown or removed fields return 422.

base_version
integer | null
persona
string | null
system_prompt
string | null
system_context_variables
SystemContextVariableSpec · object[] | null
context_variables
LegacySystemContextVariableSpec · object[] | null
deprecated

Deprecated alias for system_context_variables.

variable_defaults
Variable Defaults · object | null
channel_specific_config
Channel Specific Config · object | null
router_config_id
string<uuid> | null
model_settings
ModelChainEntry · object | null
analyzer_model_settings
ModelChainEntry · object | null

Assistant-revision override for the bound workflow analyzer; stored but inactive while the assistant has no effective workflow.

workflow_enabled
boolean
default:false

Run the stored workflow for this revision. Omitted leaves it unchanged; explicit null is invalid.

memory_enabled
boolean
default:true

Enable semantic memory recall and ingestion for this revision.

current_time
CurrentTimeSettings · object | null

One tier's optional current-time overrides.

None means inherit for that field. An empty object therefore clears the tier and inherits both values. The API stores only non-null fields.

kb_clearance_level
integer | null
kb_audience_tags
string[] | null
tool_refs
ToolRef · object[] | null
knowledge_base_refs
KnowledgeBaseRef · object[] | null
platform_tools
Platform Tools · object | null
continue_after_flow
boolean | null

Response

Successful Response

Response for revision create/update — the revision + optimistic version.

revision
AgentRevisionResponse · object
required
version
integer
default:0
prompt_findings
ValidationFinding · object[]

Non-blocking authoring diagnostics for assistant persona/system-prompt mentions. Error severity does not mean an ordinary draft write failed; activation and active-revision updates block until these findings resolve.