---
title: "Validate Agent YAML configuration"
method: POST
path: "/v1/agents/validate"
tags: ["Agent Operations"]
---

# Validate Agent YAML configuration

`POST /v1/agents/validate`

Validates the agent network configuration provided as a YAML file or string. Only files with a .yaml or .yml extension are accepted.

## Response `200`

Successful Response

- AgentValidationResponse
  - `request_metadata` ResponseMeta
    - `request_id` string, nullable — Unique request identifier for tracing and support.
  - `status` string, required — The result status of the validation.
  - `message` string, required — Detailed message about the validation outcome.
  - `suggestion` string, nullable — Optional suggestion if any errors were found.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/svahnar/apis/svahnar-apis.md) · [All operations](https://skmtc.net/svahnar/apis/svahnar-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/svahnar/svahnar-apis/revisions/02cca47c900a/schema)