---
title: "List Policy Attachments"
method: GET
path: "/policies/attachments/list"
tags: ["Policies"]
---

# List Policy Attachments

`GET /policies/attachments/list`

List all policy attachments from the database.

Example Request:
```bash
curl -X GET "http://localhost:4000/policies/attachments/list" \
    -H "Authorization: Bearer <your_api_key>"
```

Example Response:
```json
{
    "attachments": [
        {
            "attachment_id": "123e4567-e89b-12d3-a456-426614174000",
            "policy_name": "global-baseline",
            "scope": "*",
            "teams": [],
            "keys": [],
            "models": [],
            "created_at": "2024-01-01T00:00:00Z",
            "updated_at": "2024-01-01T00:00:00Z"
        }
    ],
    "total_count": 1
}
```

## Response `200`

Successful Response

- PolicyAttachmentListResponse — Response for listing policy attachments.
  - `attachments` PolicyAttachmentDBResponse[] — List of policy attachments.
    - `attachment_id` string, required — Unique ID of the attachment.
    - `policy_name` string, required — Name of the attached policy.
    - `scope` string, nullable — Scope of the attachment.
    - `teams` string[] — Team patterns.
    - `keys` string[] — Key patterns.
    - `models` string[] — Model patterns.
    - `tags` string[] — Tag patterns.
    - `created_at` string, date-time, nullable — When the attachment was created.
    - `updated_at` string, date-time, nullable — When the attachment was last updated.
    - `created_by` string, nullable — Who created the attachment.
    - `updated_by` string, nullable — Who last updated the attachment.
  - `total_count` integer — Total number of attachments.

## Changes

- **2026-08-29** `404bba17aabe` — 2 info
  - api tag `Policies` added
  - api tag `policy_engine` removed
- **2026-08-27** `4a06c3148b6c` — 2 info
  - api tag `policy_engine` added
  - api tag `Policies` removed
- **2026-08-15** `19cc785a8024` — 2 info
  - api tag `Policies` added
  - api tag `policy_engine` removed
- **2026-08-14** `9c80d9af446a` — 2 info
  - api tag `policy_engine` added
  - api tag `Policies` removed
- **2026-08-12** `cd946846d9d5` — 2 info
  - api tag `Policies` added
  - api tag `policy_engine` removed

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/policies/attachments/list/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flock/litellm-api/revisions/79b9ccc6f1dd/schema)