Validate Agent Import

Body

application/json

Unified request model for agent import.

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

Input Method	Mode	Access Level	Description
agent_url	Remote	black_box	Just an endpoint URL to call
agent_card	Local	grey_box	Upload agent configuration/card JSON
source_code	Local	white_box	Upload 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

Hide child attributes

source_code.files

Files · object

required

Map of filename to content. Use 'main.py' for single file uploads.

Hide child attributes

source_code.files.{key}

string

source_code.entry_point

string

default:main.py

Main entry point file (must exist in files)

source_code.framework

string

default:unknown

Framework identifier (for informational purposes only)

source_code.agent_name

string | null

Agent name (extracted from code if not provided)

source_code.model_name

string | null

Model name used by the agent

source_code.description

string | null

Agent description

source_code.system_prompt

string | null

System prompt if known

source_code.tools

string[] | null

List of tools/functions the agent uses

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