---
title: "List Agent Policies"
method: GET
path: "/policies/agent"
tags: ["policy"]
---

# List Agent Policies

`GET /policies/agent`

## Query parameters

- `limit` integer
- `offset` integer
- `name` string
- `order` 'name' | 'id'
- `dir` 'asc' | 'desc'
- `tags` object

## Response `200`

Data retrieved.

- PolicyPageSchema
  - `policy` PolicyObjSchema[], required
    - `id` string, uuid, required — Unique identifier (UUID)
    - `name` string — A unique name label
    - `description` string — User description of this Policy
    - `tags` object — User defined key/values for organization and searching
    - `backend` string — The policy backend to use. Cannot change once created.
    - `ts_created` string, date-time — Timestamp of creation
    - `version` integer — A monotonically increasing counter starting at 0 on creation and increasing with each policy update.
    - `policy` object — Agent backend specific policy data in json format
    - `format` string — Policy text format needed to specify when a policy was created in yaml format.
    - `policy_data` string — Agent backend specific policy data in yaml format
  - `total` integer — Total number of items.
  - `offset` integer — Number of items to skip during retrieval.
  - `limit` integer — Maximum number of items to return in one page.

## Other responses

- `400` — Failed due to malformed query parameters.
- `401` — Missing or invalid access token provided.
- `404` — A non-existent entity request.
- `500` — Unexpected server-side error occurred.

## 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-09-27** `5085d5b16a49` — 2 breaking
  - for the `query` request parameter `tags`, default value `{"key":"value"}` was removed
  - for the `query` request parameter `tags`, the type/format was changed from `string`/`` to `object`/``
- **2022-03-28** `5d3c055b50ec` — 2 info
  - added the optional property `policy/items/format` to the response with the `200` status
  - added the optional property `policy/items/policy_data` to the response with the `200` status
- **2021-09-22** `dc9b53b51fdd` — 1 breaking
  - the `policy/items/policy` response's property type/format changed from `string`/`` to `object`/`` for status `200`

[Full history](https://skmtc.dev/orb-community/apis/orb-policies/changes/policies/agent/get.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-service-production.skmtc.workers.dev/v1/apis/orb-community/orb-policies/revisions/d95ee7691efb/schema)