VIvijilai
Agent Environment
agent-configurations

Update Agent Configuration

Update an existing agent configuration.

Supports partial updates - you can update just the api_key field, or any other field(s). All fields in the request body are optional.

Requires agent:write permission + billing feature 'write_custom_agent'.

Example: # Update only the API key PUT /agent-configurations/{id} { "api_key": "sk-new-key-value" }

# Update multiple fields
PUT /agent-configurations/{id}
{
  "agent_name": "New Name",
  "api_key": "sk-new-key-value",
  "mcp_config": {"proxy_url": "https://proxy.example.com", "access_level": "read"}
}

# Enable/disable dome auto-apply (when true, saving dome config auto-applies it)
PUT /agent-configurations/{id}
{
  "dome_manually_configured": true
}
put/v1/agent-configurations/{id}

Request

Path parameters

idstring uuid required

Request body

status'draft' | 'creating' | 'active' | 'under_review' | 'deprecated' | 'archived' | 'pending' | 'rejected'

Agent status values.

agent_namestring nullable
agent_urlstring nullable
model_namestring nullable
api_keystring nullable

API key value. Stored directly in the agent configuration.

agent_system_promptstring nullable
hubstring nullable
rate_limit_requests_per_minuteinteger nullable

Rate limit for API requests per minute

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.

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

Dome protection lifecycle state.

dome_config_idstring uuid nullable
dome_manually_configuredboolean 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

Changes

No recorded changes to this operation across all 1 revision of this API.