---
title: "Changes to Validate an Agent Policy configuration without saving it"
method: POST
path: "/policies/agent/validate"
---

# Changes to Validate an Agent Policy configuration without saving it

`POST /policies/agent/validate`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 16 of 25 revisions.

- **2026-07-17** `d95ee7691efb` — 1 breaking
- **2022-10-04** `ce59b3bdec00` — 1 breaking
- **2022-03-28** `5d3c055b50ec` — 2 info
- **2022-01-13** `456757f3b554` — 2 info
- **2022-01-12** `b3e28725ccae` — 6 info
- **2021-09-22** `dc9b53b51fdd` — 1 breaking
- **2021-09-20** `36e163b84ec9` — 1 breaking, 7 warning, 1 info
- **2021-09-14** `e0d05716908c` — 1 breaking, 1 info
- **2021-09-10** `90506e561cb6` — 2 info
- **2021-08-31** `adfab293130f` — 2 breaking
- **2021-08-30** `0ab4ab3de1eb` — 1 info
- **2021-08-27** `c6c0b44a92ea` — 1 breaking
- **2021-08-27** `3b5c71fcf139` — 1 info
- **2021-08-27** `38562e9cb8e7` — 1 breaking
- **2021-08-27** `cb4b72ec6b0d` — 1 info
- **2021-06-29** `e95a4da3dd7a` — 1 breaking

## Changes

- **2026-07-17** `d95ee7691efb` — 1 breaking
  - added the new required `header` request parameter `Authorization` to all path's operations
- **2022-10-04** `ce59b3bdec00` — 1 breaking
  - added the new required `header` request parameter `Bearer authorization` to all path's operations
- **2022-03-28** `5d3c055b50ec` — 2 info
  - added the optional property `format` to the response with the `200` status
  - added the optional property `policy_data` to the response with the `200` status
- **2022-01-13** `456757f3b554` — 2 info
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/schema_version`
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaYaml]/schema_version`
- **2022-01-12** `b3e28725ccae` — 6 info
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/policy/handlers`
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/policy/input`
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/policy/kind`
  - added the new optional request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/version`
  - the request property `oneOf[#/components/schemas/PolicyCreateReqSchemaJson]/description` became optional
  - the request property `oneOf[#/components/schemas/PolicyCreateReqSchemaYaml]/description` became optional
- **2021-09-22** `dc9b53b51fdd` — 1 breaking
  - the `policy` response's property type/format changed from `string`/`` to `object`/`` for status `200`
- **2021-09-20** `36e163b84ec9` — 1 breaking, 7 warning, 1 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `backend`
  - removed the request property `description`
  - removed the request property `format`
  - removed the request property `name`
  - removed the request property `policy`
  - removed the request property `policy_data`
  - removed the request property `tags`
  - added `#/components/schemas/PolicyCreateReqSchemaJson, #/components/schemas/PolicyCreateReqSchemaYaml` to the request body `oneOf` list
- **2021-09-14** `e0d05716908c` — 1 breaking, 1 info
  - the `policy` request property type/format changed from `string`/`` to `object`/``
  - the request property `policy` became optional
- **2021-09-10** `90506e561cb6` — 2 info
  - added the new optional request property `format`
  - added the new optional request property `policy_data`
- **2021-08-31** `adfab293130f` — 2 breaking
  - the `policy` request property type/format changed from `object`/`` to `string`/``
  - the `policy` response's property type/format changed from `object`/`` to `string`/`` for status `200`
- **2021-08-30** `0ab4ab3de1eb` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2021-08-27** `c6c0b44a92ea` — 1 breaking
  - added the new required request property `policy`
- **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

---

[Operation](https://skmtc.dev/orb-community/apis/orb-policies/docs/policies/agent/validate/post.md) · [API](https://skmtc.dev/orb-community/apis/orb-policies.md) · [Page](https://skmtc.dev/orb-community/apis/orb-policies/changes/policies/agent/validate/post)