Skip to main content
POST
Validate Agent Import

Body

application/json

Unified request model for agent import.

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

agent_url
string | null

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

agent_card
Agent Card · object | null

Local grey_box: Upload agent configuration/card JSON directly

source_code
SourceCodeUpload · object | null

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 | null

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 | null
errors
string[]
warnings
string[]
external_id
string | null
identity_provider
string | null
Last modified on April 21, 2026