GET /folders

List all folders the authenticated user is a member of.

List the folders the authenticated user can access. Use the returned id values in folderIds when you want generated output stored in a specific folder.

List folders

get

Lists all folders the authenticated user is a member of within the workspace.

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Query parameters

querystringOptional

Search query to filter folders by name

Example: marketing

limitnumber · min: 1 · max: 50Optional

Maximum results to return

Example: 20

afterstringOptional

Pagination cursor from previous response

Example: eyJpZCI6IjEyMyJ9

Responses

200

Folders retrieved successfully

application/json

hasMorebooleanRequired

Whether more results are available

Example: true

nextCursorstring · nullableOptional

Cursor for next page, null if no more results

Example: eyJpZCI6IjQ1NiJ9

401

Invalid or missing API key

get

/v1.0/folders

HTTPcURLJavaScriptPython

GET /v1.0/folders HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "folder_abc123",
      "name": "Marketing Materials"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjQ1NiJ9"
}

For guidance on when to fetch folder IDs and how to use them in requests, see Use themes and folders.

Related

• Use themes and folders for workflow guidance

• POST /generations if you want to place output into one or more folders