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>",
"access_level": "read",
"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": "manual",
"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
}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.
Successful Response
List response model.
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
MCP (Model Context Protocol) proxy configuration.
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.
Agent capability flags.
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
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>",
"access_level": "read",
"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": "manual",
"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
}