---
title: "Validate an Agent Policy configuration without saving it"
method: POST
path: "/policies/agent/validate"
tags: ["policy"]
---

# Validate an Agent Policy configuration without saving it

`POST /policies/agent/validate`

## Request body

- PolicyCreateReqSchema
  - `name` string, required — A unique name label
  - `description` string, required — User description of this Policy
  - `tags` object, required — User defined key/values for organization and searching
  - `backend` string, required — Agent backend this policy is for. Cannot change once created.

## Other responses

- `200` — unresolved $ref
- `400` — Failed due to malformed JSON.
- `401` — Missing or invalid access token provided.
- `415` — Missing or invalid content type.
- `500` — Unexpected server-side error occurred.

## Changes

- **2021-08-27** `3b5c71fcf139` — 1 info
  - endpoint added
- **2021-08-27** `38562e9cb8e7` — 1 breaking
  - api path removed without deprecation
- **2021-08-27** `cb4b72ec6b0d` — 1 info
  - endpoint added
- **2021-06-29** `e95a4da3dd7a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/orb-community/apis/orb-policies/changes/policies/agent/validate/post.md)

---

[API](https://skmtc.dev/orb-community/apis/orb-policies.md) · [All operations](https://skmtc.dev/orb-community/apis/orb-policies/llms.txt) · [OpenAPI document](https://skmtc.dev/orb-community/apis/orb-policies/revisions/3b5c71fcf139?raw)