Sign in

v1

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

Update Agent Lifecycle

Update agent trust lifecycle stage.

Requires agent:write permission (all team members) or agent:write_all permission (super admin).

Setting trust_stage to 'hardened' captures trusted_at and computes ttt_days.

put/v1/agent-configurations/{id}/lifecycle

Path parameters

idstring uuid required

Request body

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

Trust maturity lifecycle stage for an agent.

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