---
title: "Validate Agent Import"
method: POST
path: "/v1/agent-configurations/import/validate"
tags: ["Agent Environment", "agent-import"]
---

# Validate Agent Import

`POST /v1/agent-configurations/import/validate`

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.

## Request body

- UnifiedImportRequest — 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, nullable — Remote black_box: Agent endpoint URL to call (e.g., https://api.example.com/agent)
  - `agent_card` object, nullable — Local grey_box: Upload agent configuration/card JSON directly
  - `source_code` SourceCodeUpload — Model for direct source code upload. Supports single file or multi-file upload for white box agent import.
    - `files` object, required — Map of filename to content. Use 'main.py' for single file uploads.
    - `entry_point` string — Main entry point file (must exist in files)
    - `framework` string — Framework identifier (for informational purposes only)
    - `agent_name` string, nullable — Agent name (extracted from code if not provided)
    - `model_name` string, nullable — Model name used by the agent
    - `description` string, nullable — Agent description
    - `system_prompt` string, nullable — System prompt if known
    - `tools` string[], nullable — List of tools/functions the agent uses
  - `framework` string, nullable — Framework identifier (for informational purposes only)
  - `entry_point` string, nullable — For white box: path to main file
  - `override_name` string, nullable — Override agent name
  - `rate_limit_requests_per_minute` integer
  - `api_key` string, nullable — API key for the agent
  - `external_id` string, nullable — External identity ID
  - `identity_provider` string, nullable — Identity provider name
  - `idp_metadata` object, nullable — IdP-specific metadata

## Response `200`

Successful Response

- UnifiedValidationResponse — Response model for unified validation. Returns validation status and parsed agent card for preview.
  - `valid` boolean, required
  - `access_level` string, nullable
  - `agent_card` object, nullable
  - `errors` string[]
  - `warnings` string[]
  - `external_id` string, nullable
  - `identity_provider` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)