GET /folders

List all folders the authenticated user is a member of.

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

What folders are

Folders organize Gammas within a workspace. When you generate content via the API, it lands in the workspace root by default. Pass a folder id as folderIds in POST /generations or POST /generations/from-template to file the generated Gamma into that folder.

Pagination

Results are cursor-paginated. Each response includes hasMore (boolean) and nextCursor (string or null). To fetch the next page, pass the nextCursor value as the after query parameter. Use limit (1-50, default 20) to control page size. Use query to filter folders by name.

List folders

get

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

Authorizations

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 number of folders to return

Example: 20

afterstringOptional

Cursor for pagination (from previous response's nextCursor)

Example: eyJpZCI6IjEyMyJ9

Responses

200

Folders retrieved successfully

application/json

hasMorebooleanRequired

Whether more results exist beyond this page

Example: true

nextCursorstring · nullableRequired

Cursor for fetching the next page (null if no more results)

Example: eyJpZCI6IjQ1NiJ9

400

Invalid request parameters

401

Invalid or missing API key

get/v1.0/folders

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 a folder