Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB
Agent Environment
agent-import

Validate Agent Import

Validate an agent import request without saving.

Supports three input methods with deterministic access levels:

  • 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

Returns validation status, access level, and parsed agent card for preview.

post/v1/agent-configurations/import/validate

Request body

agent_urlstring nullable

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

agent_cardobject nullable

Local grey_box: Upload agent configuration/card JSON directly

frameworkstring nullable

Framework identifier (for informational purposes only)

entry_pointstring nullable

For white box: path to main file

override_namestring nullable

Override agent name

rate_limit_requests_per_minuteinteger
api_keystring nullable

API key for the agent

external_idstring nullable

External identity ID

identity_providerstring nullable

Identity provider name

idp_metadataobject nullable

IdP-specific metadata

Response

Successful Response

validboolean required
access_levelstring nullable
agent_cardobject nullable
errorsstring[]
warningsstring[]
external_idstring nullable
identity_providerstring nullable