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
}

idstring uuid required

Request body

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

Agent status values.

created_atinteger required

updated_atinteger required