GET /gammas/{gammaId}/comments

Returns comment threads on a Gamma, cursor-paginated. Supports an updatedSince filter for efficient delta polling.

List comment threads on a single Gamma with cursor pagination.

List comments on a Gamma

get

Returns comment threads on a Gamma, cursor-paginated. Supports an updatedSince filter for efficient delta polling.

Authorizations

X-API-KEYstringRequired

API key for authentication

Path parameters

gammaIdstringRequired

The ID of the Gamma to list comments for

Query parameters

limitnumber · min: 1 · max: 50Optional

Maximum number of comments to return per page

Example: 20

afterstringOptional

Cursor for pagination (from previous response's nextCursor)

Example: eyJpZCI6IjEyMyJ9

updatedSincestringOptional

ISO-8601 timestamp cursor. When provided, only comment threads with activity (including new replies) after this timestamp are returned — enabling efficient delta polling.

Example: 2026-06-01T00:00:00.000Z

includeArchivedbooleanOptional

When true, archived (deleted) comments and replies are included in the response, each carrying an archived flag. Defaults to false.

Example: false

Responses

200

Comments 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 (e.g. malformed updatedSince)

401

Invalid or missing API key

403

Insufficient permissions — caller must have comment-level access

404

Gamma not found

get/v1.0/gammas/{gammaId}/comments

GET /v1.0/gammas/{gammaId}/comments HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "comment_abc123",
      "cardId": "card_abc123",
      "targetText": "The revenue grew by 30%",
      "targetHtml": "The revenue grew by <strong>30%</strong>",
      "author": {
        "id": "user_abc123",
        "name": "Jane Doe"
      },
      "contentText": "Can we add a source for this stat?",
      "status": "open",
      "archived": false,
      "mentionedUsers": [
        "text"
      ],
      "replies": [
        {
          "id": "reply_abc123",
          "author": {
            "id": "user_abc123",
            "name": "Jane Doe"
          },
          "contentText": "Good catch — Ill fix this.",
          "mentionedUsers": [
            "text"
          ],
          "archived": false,
          "createdTime": "2026-06-01T12:00:00.000Z",
          "updatedTime": "2026-06-01T12:30:00.000Z"
        }
      ],
      "createdTime": "2026-06-01T10:00:00.000Z",
      "updatedTime": "2026-06-01T10:30:00.000Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjQ1NiJ9"
}

Requires comment-level access on the Gamma. Use limit (1–50) and after to paginate. Pass updatedSince (ISO-8601) to fetch only comment threads with activity (including new replies) after that timestamp. Set includeArchived to true to include archived (deleted) comments and replies.

Related

• GET /gammas/{gammaId} for title, thumbnail, and URL metadata
• Poll for results for polling patterns that also apply to updatedSince delta sync
• Use themes and folders for cursor-pagination patterns used by after
• Error codes for authentication and permission failures