Skip to main content
POST
Create an assistant (agent + workflow) as one unit

Authorizations

x-api-key
string
header
required

Body

application/json

Request body for POST /assistants — create an agent + workflow as one unit.

Q1: every assistant gets a workflow shell at creation; an empty flow (instructions="") is legal and runs the bare-agent path.

name
string
required
description
string | 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
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.

analyzer_model_settings
ModelChainEntry · object | null

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

memory_enabled
boolean
default:true

Enable semantic memory recall and ingestion for this revision.

router_model_settings
Router Model Settings · object | null
metadata
Metadata · object | null
kb_clearance_level
integer | null
kb_audience_tags
string[] | null
knowledge_gap_analysis_enabled
boolean
default:true
tool_refs
ToolRef · object[] | null
knowledge_base_refs
KnowledgeBaseRef · object[] | null
instructions
string
default:""
workflow_description
string | null

Response

Successful Response

Response for POST /assistants — the created agent + workflow.

agent
AgentResponse · object
required
agent_revision
AgentRevisionResponse · object
required
workflow
WorkflowResponse · object
required
workflow_revision_id
string<uuid>
required