Sign in

v1

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

Get Agent Configuration By Id

Get a single agent configuration by ID.

Requires agent:read permission (all team members) or agent:read_all permission (super admin).

get/v1/agent-configurations/{id}

Path parameters

idstring uuid required

Query parameters

include_scoresboolean

When true, sideloads the latest completed evaluation scores onto the agent.

When true, sideloads the latest completed evaluation scores onto the 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