---
title: "Create new Agent Policy"
method: POST
path: "/policies/agent"
tags: ["policy"]
---

# Create new Agent Policy

`POST /policies/agent`

## 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

- `201` — unresolved $ref
- `400` — Failed due to malformed JSON
- `401` — Missing or invalid access token provided.
- `409` — Entity already exist.
- `415` — Mising or invalid content type.
- `422` — Database can't process request.
- `500` — Unexpected server-side error occurred.

## Changes

- **2021-08-27** `3b5c71fcf139` — 6 breaking, 3 warning, 7 info
  - added the new required `header` request parameter `Authorization` to all path's operations
  - added the new required request property `description`
  - added the new required request property `tags`
  - the request property `backend` became required
  - …12 more
- **2021-08-27** `38562e9cb8e7` — 2 breaking, 12 info
  - the request's body type changed from no type to `object`
  - removed the success response with the status `201`
  - added the new optional request property `backend`
  - added the new optional request property `format`
  - …10 more
- **2021-08-27** `cb4b72ec6b0d` — 3 breaking, 5 warning, 7 info
  - added the new required `header` request parameter `Authorization` to all path's operations
  - the request's body type changed from `object` to no type
  - removed the success response with the status `200`
  - removed the request property `backend`
  - …11 more
- **2021-07-01** `9bf27c32eb50` — 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/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)