Get Multiple Folders

Retrieves multiple folders and their snippets. API Cost: M + N requests (M for folders + N for total snippets).

GET /folders

Get multiple folders

cURL

curl --request GET \
  --url https://www.getsnippets.ai/api/prompts/folders \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "success": true,
  "data": {
    "folders": [
      {}
    ]
  },
  "usage": {
    "remainingRequests": 123,
    "usageDeducted": 123
  },
  "pagination": {
    "limit": 123,
    "offset": 123,
    "totalSnippets": 123,
    "hasMore": true,
    "currentPage": 123,
    "totalPages": 123
  }
}

Authorizations

Authorization · string · header · required

API key authentication using Bearer token. Include your API key in the Authorization header.

Query Parameters

ids · string · required

Comma-separated list of folder IDs or JSON array

limit · integer · default: 20

Maximum number of snippets per folder (default: 20)

Required range: 1 <= x <= 100

offset · integer · default: 0

Number of snippets to skip per folder (default: 0)

Required range: x >= 0

Response

200

application/json

Folders retrieved successfully

success · boolean

Example:

true

data · object

Show child attributes

usage · object

Show child attributes

pagination · object

Show child attributes