Skip to main content
POST
/
v1
/
agent-configurations
Create Agent Configuration
curl --request POST \
  --url https://api.example.com/v1/agent-configurations/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "hub": "custom",
  "model_name": "<string>",
  "agent_name": "<string>",
  "agent_url": "<string>",
  "hub_config": {},
  "status": "active",
  "api_key_id": "<string>",
  "api_key": "<string>",
  "agent_system_prompt": "<string>",
  "agent_policy_files": [
    "<string>"
  ],
  "rag_params": {},
  "function_route_params": {},
  "mcp_config": {
    "proxy_url": "<string>",
    "access_level": "read",
    "server_urls": [
      "<string>"
    ]
  }
}
'
{
  "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
  }
}

Body

application/json

Request model for creating agent configurations (POST /agent-configurations).

Used only by the create endpoint. The update endpoint (PUT /{id}) accepts AgentUpdate instead. model_name and agent_name are required for create (validated in endpoint). hub_config, api_key_id, agent_policy_files are ignored for backward compat.

​
id
string | null
​
hub
string
default:custom
​
model_name
string | null
​
agent_name
string | null
​
agent_url
string | null
​
hub_config
Hub Config · object
​
status
string
default:active
​
api_key_id
string | null
​
api_key
string | null
​
agent_system_prompt
string | null
​
agent_policy_files
string[] | null
​
rag_params
Rag Params · object
​
function_route_params
Function Route Params · object
​
mcp_config
MCPConfig · object

MCP (Model Context Protocol) proxy configuration.

Response

Successful Response

Agent domain model.

​
id
string<uuid>
required
​
agent_name
string
required
​
model_name
string
required
​
team_id
string<uuid>
required
​
created_by
string<uuid>
required
​
created_at
integer
required
​
updated_at
integer
required
​
agent_url
string | null
​
hub
string
default:custom
​
api_key
string | null
​
agent_system_prompt
string | null
​
rate_limit_requests_per_minute
integer
default:100

Rate limit for API requests per minute

Required range: x >= 1
​
status
enum<string>
default:active

Agent status values.

Available options:
draft,
creating,
active,
under_review,
deprecated,
archived,
pending,
rejected
​
access_level
enum<string>
default:black_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

Available options:
black_box,
grey_box,
white_box
​
agent_params
AgentParams · object

Model parameters for agent configuration.

​
mcp_config
MCPConfig · object

MCP (Model Context Protocol) proxy configuration.

​
delegated_agents
DelegatedAgent · object[]
​
white_box_config
WhiteBoxConfig · object

Source code access configuration for white box analysis.

​
agent_metadata
AgentMetadata · object

Agent metadata for display and organization.

​
purpose
string | null
​
protocol
enum<string>
default:chat_completions

Communication protocol for agent endpoints.

Available options:
chat_completions,
a2a
​
test_score
string | null
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
last_tested_by
string | null
​
evaluated_harnesses
string[] | null
​
last_evaluated_at
integer | null
​
protection_status
enum<string>
default:unprotected

Dome protection lifecycle state.

Available options:
unprotected,
configured,
domed
​
trust_stage
enum<string>
default:registered

Trust maturity lifecycle stage for an agent.

Available options:
registered,
tested,
hardened,
trusted,
optimized,
adapted
​
trusted_at
integer | null
​
ttt_days
number | null
​
dome_config_id
string<uuid> | null
​
dome_manually_configured
boolean
default:false
​
import_metadata
ImportMetadata · object

Metadata about how an agent was imported.

​
capabilities
AgentCapabilities · object

Agent capability flags.

​
skills
(AgentSkill · object | object)[]

An agent skill definition (for A2A protocol agents).

​
latest_evaluation
AgentLatestEvaluation · object

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.

Last modified on April 21, 2026