Skip to main content
POST
Create a new revision (optionally branch from an existing one)

Authorizations

x-api-key
string
header
required

Path Parameters

agent_id
string<uuid>
required

Body

application/json

Request body for POST /assistants/{id}/revisions — create a new revision.

based_on_revision_id
string<uuid> | null
name
string | null
Maximum string length: 255
description
string | null

Response

Successful Response

id
string<uuid>
required
agent_id
string<uuid>
required
name
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
system_context_variables
SystemContextVariableSpec · object[] | null
required

Assistant-owned immutable inputs. Derived variables belong to workflows.

description
string | null
persona
string | null
system_prompt
string | null
context_variables
ContextVarSpec · object[] | null
deprecated

Deprecated legacy projection; contains assistant SYSTEM declarations only. Use system_context_variables.

variable_defaults
Variable Defaults · object | null
tool_refs
Tool Refs · object[] | null
knowledge_base_refs
Knowledge Base Refs · object[] | null
platform_tools
Platform Tools · object
policies_enabled
boolean
default:true
policy_refs
Policy Refs · 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
workflow_enabled
boolean
default:false
memory_enabled
boolean
default:true
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[]
continue_after_flow
boolean | null
voice_call_settings
Voice Call Settings · object | null
created_by
string | null
published_at
string<date-time> | null