---
search:
  tags:
    - agents
    - GET
seo:
  description: >-
    List guidance packs for the workspace. Optional scope/scopeKey… Reference
    for the GET /workspaces/{organizationId}/agent/guidance endpoint in the Pile
    API.
sidebar:
  label: List agent guidance
  badge: GET
title: List agent guidance
type: openapi-operation
---
List guidance packs for the workspace. Optional scope/scopeKey filters narrow to one attachment level.

`GET /workspaces/{organizationId}/agent/guidance`

**Responses**

- `200` — Guidance packs

Response example, 200:

```json
{
  "packs": [
    {
      "id": "string",
      "organizationId": "string",
      "name": "string",
      "scope": "workspace",
      "scopeKey": "string",
      "body": "string",
      "links": [
        {
          "label": "string",
          "url": "string"
        }
      ],
      "version": 0,
      "createdBy": "string",
      "updatedBy": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}
```