---
title: "Validate agent configuration (Enterprise)"
method: POST
path: "/api/v1/agents/validate"
tags: ["Agents"]
---

# Validate agent configuration (Enterprise)

`POST /api/v1/agents/validate`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/agents/validate`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/agents/validate/post.ts> (a function with typed inputs; its response is checked against the schema)

Validates an agent configuration without creating it.
Useful for dry-run validation before deployment.

**Enterprise only** - the `/api/v1/agents` family is not registered in Community.

Checks:
- Required fields present
- Name/domain format valid
- Agent types valid (llm-call, connector-call)
- LLM config complete for llm-call agents
- Routing rules reference defined agents

## Request body

- ValidateAgentRequest
  - `name` string
  - `domain` string
  - `config` AgentConfigSpec, required: Agent configuration specification
    - `execution` object
      - `default_mode` 'auto' | 'parallel' | 'sequential'
      - `max_parallel_tasks` integer
      - `timeout_seconds` integer
    - `agents` AgentDefinition[]
      - `name` string, required
      - `type` 'llm-call' | 'connector-call', required
      - `llm` object: LLM config (required for llm-call type)
        - `provider` string
        - `model` string
      - `connector` object: Connector config (required for connector-call type)
        - `name` string
        - `operation` string
    - `routing` RoutingRule[]
      - `pattern` string, required: Regex pattern to match
      - `agent` string, required: Target agent name
      - `priority` integer: Higher priority rules match first

## Response `200`

Validation result

- ValidationResponse
  - `valid` boolean
  - `errors` string[]

## Other responses

- `400`: Validation failed

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)