Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB
Agent Environment
agent-configurations

Create Agent Configuration

Create a new agent configuration.

This endpoint accepts AgentConfigRequest format from the frontend and transforms it to the internal AgentCreate format. The agent_url field is preserved.

Requires agent:write permission.

post/v1/agent-configurations/

Request body

idstring nullable
hubstring
model_namestring nullable
agent_namestring nullable
agent_urlstring nullable
hub_configobject nullable
statusstring
api_key_idstring nullable
api_keystring nullable
agent_system_promptstring nullable
agent_policy_filesstring[] nullable
rag_paramsobject nullable
function_route_paramsobject nullable

Response

Successful Response

idstring uuid required
agent_namestring required
model_namestring required
agent_urlstring nullable
hubstring
api_keystring nullable
agent_system_promptstring nullable
rate_limit_requests_per_minuteinteger

Rate limit for API requests per minute

team_idstring uuid required
created_bystring uuid required
status'draft' | 'creating' | 'active' | 'under_review' | 'deprecated' | 'archived' | 'pending' | 'rejected'

Agent status values.

created_atinteger required
updated_atinteger required
access_level'black_box' | 'grey_box' | 'white_box'

Access level for agent analysis.

Black Box: URL only - behavioral testing only Grey Box: Agent configuration - structure/capabilities analysis White Box: Source code access - full code + sandbox runtime analysis

purposestring nullable
protocol'chat_completions' | 'a2a'

Communication protocol for agent endpoints.

test_scorestring nullable
last_tested_bystring nullable
evaluated_harnessesstring[] nullable
last_evaluated_atinteger nullable
protection_status'unprotected' | 'configured' | 'domed'

Dome protection lifecycle state.

trust_stage'registered' | 'tested' | 'hardened' | 'trusted' | 'optimized' | 'adapted'

Trust maturity lifecycle stage for an agent.

trusted_atinteger nullable
ttt_daysnumber nullable
dome_config_idstring uuid nullable
dome_manually_configuredboolean