Skip to main content
POST
Import Agent Unified

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 import.

agent
Agent · object
required

Agent domain model.

access_level
string
required
warnings
string[]
external_id
string | null
identity_provider
string | null
Last modified on April 21, 2026