agents
Create an agent
post/v1/agents
Request body
namestring required
descriptionstring nullable
personastring nullable
system_promptstring nullable
global_skill_idsstring[] nullable
variable_defaultsobject nullable
channel_specific_configobject nullable
router_config_idstring uuid nullable
metadataobject nullable
kb_clearance_levelinteger nullable
kb_audience_tagsstring[] nullable
knowledge_gap_analysis_enabledboolean
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' | 'blocking'
Per-agent release-gate mode (ENG-727). off = no release checks; advisory = compute + display a verdict but never block activation; blocking = (Phase 2) refuse activation without a fresh passing verdict. Dormant in Phase 1 — only the Phase-2 activation gate reads it.
release_gate_max_failuresinteger
created_atstring date-time required
updated_atstring date-time required