Get Agent Configurations
List agent configurations with filtering and pagination.
Requires agent:read permission (all team members) or agent:read_all permission (super admin).
curl --request GET \
--url https://api.example.com/v1/agent-configurations/{
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_name": "<string>",
"model_name": "<string>",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": 123,
"updated_at": 123,
"agent_url": "<string>",
"hub": "custom",
"api_key": "<string>",
"agent_system_prompt": "<string>",
"rate_limit_requests_per_minute": 100,
"status": "active",
"access_level": "black_box",
"agent_params": {
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"timeout": 123,
"rag_params": {},
"function_route_params": {}
},
"mcp_config": {
"proxy_url": "<string>",
"server_urls": [
"<string>"
]
},
"delegated_agents": [
{
"url": "<string>",
"agent_card_url": "<string>",
"name": "<string>",
"capabilities": [
"<string>"
]
}
],
"white_box_config": {
"source_code": "<string>",
"repo_url": "<string>",
"github_username": "<string>",
"repo_branch": "<string>",
"entry_point": "<string>"
},
"agent_metadata": {
"role": "<string>",
"job_description": "<string>",
"version": "<string>",
"author": "<string>",
"tags": [
"<string>"
]
},
"purpose": "<string>",
"protocol": "chat_completions",
"test_score": "<string>",
"last_tested_by": "<string>",
"evaluated_harnesses": [
"<string>"
],
"last_evaluated_at": 123,
"protection_status": "unprotected",
"trust_stage": "registered",
"trusted_at": 123,
"ttt_days": 123,
"dome_config_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dome_manually_configured": false,
"import_metadata": {
"source_url": "<string>",
"imported_at": 123,
"original_format": "<string>"
},
"capabilities": {
"streaming": false,
"push_notifications": false,
"code_execution": false,
"memory": false,
"delegation": false,
"tools": [
"<string>"
]
},
"skills": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"input_modes": [
"<string>"
],
"output_modes": [
"<string>"
]
}
],
"latest_evaluation": {
"evaluation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"overall_score": 123,
"reliability_score": 123,
"security_score": 123,
"safety_score": 123,
"completed_at": 123
}
}
],
"count": 123
}Query Parameters
Filter by status(es). If not provided, defaults to non-archived statuses.
Maximum number of results
x >= 1Number of results to skip
x >= 0When true, sideloads the latest completed evaluation scores onto each agent.
Response
Successful Response
List response model.
Hide child attributes
Hide child attributes
Rate limit for API requests per minute
x >= 1Agent status values.
draft, creating, active, under_review, deprecated, archived, pending, rejected 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
black_box, grey_box, white_box Model parameters for agent configuration.
Hide child attributes
Hide child attributes
MCP (Model Context Protocol) proxy configuration.
Hide child attributes
Hide child attributes
1 - 2083MCP (Model Context Protocol) access level values.
read, write, admin 1 - 2083Source code access configuration for white box analysis.
Communication protocol for agent endpoints.
chat_completions, a2a ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Dome protection lifecycle state.
unprotected, configured, domed Trust maturity lifecycle stage for an agent.
registered, tested, hardened, trusted, optimized, adapted Metadata about how an agent was imported.
- ImportMetadata
- Import Metadata
Agent capability flags.
- AgentCapabilities
- Capabilities
Hide child attributes
Hide child attributes
Latest completed evaluation scores for an agent.
Sideloaded on GET /agent-configurations when include_scores=true. Contains only domain-level score data — no UI or presentation concerns.
Hide child attributes
Hide child attributes
Was this page helpful?
curl --request GET \
--url https://api.example.com/v1/agent-configurations/{
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_name": "<string>",
"model_name": "<string>",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": 123,
"updated_at": 123,
"agent_url": "<string>",
"hub": "custom",
"api_key": "<string>",
"agent_system_prompt": "<string>",
"rate_limit_requests_per_minute": 100,
"status": "active",
"access_level": "black_box",
"agent_params": {
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"timeout": 123,
"rag_params": {},
"function_route_params": {}
},
"mcp_config": {
"proxy_url": "<string>",
"server_urls": [
"<string>"
]
},
"delegated_agents": [
{
"url": "<string>",
"agent_card_url": "<string>",
"name": "<string>",
"capabilities": [
"<string>"
]
}
],
"white_box_config": {
"source_code": "<string>",
"repo_url": "<string>",
"github_username": "<string>",
"repo_branch": "<string>",
"entry_point": "<string>"
},
"agent_metadata": {
"role": "<string>",
"job_description": "<string>",
"version": "<string>",
"author": "<string>",
"tags": [
"<string>"
]
},
"purpose": "<string>",
"protocol": "chat_completions",
"test_score": "<string>",
"last_tested_by": "<string>",
"evaluated_harnesses": [
"<string>"
],
"last_evaluated_at": 123,
"protection_status": "unprotected",
"trust_stage": "registered",
"trusted_at": 123,
"ttt_days": 123,
"dome_config_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dome_manually_configured": false,
"import_metadata": {
"source_url": "<string>",
"imported_at": 123,
"original_format": "<string>"
},
"capabilities": {
"streaming": false,
"push_notifications": false,
"code_execution": false,
"memory": false,
"delegation": false,
"tools": [
"<string>"
]
},
"skills": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"input_modes": [
"<string>"
],
"output_modes": [
"<string>"
]
}
],
"latest_evaluation": {
"evaluation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"overall_score": 123,
"reliability_score": 123,
"security_score": 123,
"safety_score": 123,
"completed_at": 123
}
}
],
"count": 123
}