Sign in

v1

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

Import Agent Unified

Import an agent using the unified import endpoint.

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

Access level is determined by input method (not content).

post/v1/agent-configurations/import

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

access_levelstring required
warningsstring[]
external_idstring nullable
identity_providerstring nullable