List Playbooks

List all playbooks accessible to the authenticated user, including org-visible, shared, and official playbooks.

Requires a user-scoped API key (u:gcai_...).

GET /playbooks

List playbooks

cURL

curl --request GET \
  --url https://app.gc.ai/api/external/v1/playbooks \
  --header 'Authorization: <api-key>'

200

{
  "playbooks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "description": "<string>",
      "is_official": true,
      "created_at": "<string>"
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  }
}

Authorizations

Authorization · string · header · required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Query Parameters

limit · integer · default: 100

Max items to return (default 100, max 500)

Required range: 1 <= x <= 500

offset · integer | null · default: 0

Number of items to skip (default 0)

Required range: x >= 0

Response

200

application/json

List of playbooks

playbooks · object[] · required

Show child attributes

pagination · object · required

Show child attributes