Skip to main content
POST
/
v1
/
agent-configurations
/
import
/
validate
Validate Agent Import
curl --request POST \
  --url https://api.example.com/v1/agent-configurations/import/validate \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "valid": true,
  "access_level": "<string>",
  "agent_card": {},
  "errors": [],
  "warnings": [],
  "external_id": "<string>",
  "identity_provider": "<string>"
}

Body

application/json

Unified request model for agent import.

Supports five input methods (exactly one required), each with deterministic access level:

Input MethodModeAccess LevelDescription
agent_urlRemoteblack_boxJust an endpoint URL to call
agent_cardLocalgrey_boxUpload agent configuration/card JSON
source_codeLocalwhite_boxUpload agent source code files
​
agent_url
string | null

Remote black_box: Agent endpoint URL to call (e.g., https://api.example.com/agent)

​
agent_card
Agent Card · object

Local grey_box: Upload agent configuration/card JSON directly

​
source_code
SourceCodeUpload · object

Local white_box: Upload agent source code files directly

​
framework
string | null

Framework identifier (for informational purposes only)

​
entry_point
string | null

For white box: path to main file

​
override_name
string | null

Override agent name

​
rate_limit_requests_per_minute
integer
default:100
Required range: x >= 1
​
api_key
string | null

API key for the agent

​
external_id
string | null

External identity ID

​
identity_provider
string | null

Identity provider name

​
idp_metadata
Idp Metadata · object

IdP-specific metadata

Response

Successful Response

Response model for unified validation.

Returns validation status and parsed agent card for preview.

​
valid
boolean
required
​
access_level
string | null
​
agent_card
Agent Card · object
​
errors
string[]
​
warnings
string[]
​
external_id
string | null
​
identity_provider
string | null
Last modified on April 21, 2026