GET /gammas/{gammaId}

Returns metadata for a single gamma. Accepts a file ID or the doc ID from a gamma.app/docs/... URL.

Retrieve title, thumbnail, URL, and other metadata for a single gamma.

Get gamma metadata

get

Returns metadata for a single gamma. Accepts either a file ID or the doc ID from a gamma.app/docs/... URL. Designed for link-preview integrations (Atlassian Smart Links, Notion Link Previews).

Authorizations

api-keybearer

X-API-KEYstringRequired

API key for authentication

Path parameters

gammaIdstring · min: 1 · max: 128Required

The gamma file ID or the doc ID from the gamma.app/docs/... URL

Example: abc123def456Pattern: ^[A-Za-z0-9_-]+$

Responses

200

Gamma metadata retrieved successfully

application/json

idstringRequired

Unique gamma identifier (file ID)

Example: file_abc123

titlestringRequired

Gamma title

Example: Q3 Marketing Strategy

typestring · enumRequired

Gamma type: 'template' or 'regular'

Example: regularPossible values:

urlstringRequired

Canonical URL to view the gamma

Example: https://gamma.app/docs/Q3-Marketing-Strategy-abc123

thumbnailUrlstring · nullableRequired

URL of a thumbnail image for the gamma, or null if unavailable

Example: https://cdn.gamma.app/previews/abc123.png

descriptionstring · nullableRequired

Description or preview text for the gamma, or null if unavailable

Example: A plan for Q3.

createdTimestring · nullableRequired

ISO-8601 timestamp of when the gamma was created, or null if unavailable

Example: 2026-04-23T16:24:33.000Z

updatedTimestring · nullableRequired

ISO-8601 timestamp of when the gamma was last modified, or null if unavailable

Example: 2026-04-23T17:08:12.000Z

themeIdstring · nullableRequired

ID of the theme applied to the gamma, or null if no theme is set

Example: theme_abc123

archivedbooleanRequired

Whether the gamma is archived

Example: false

400

Invalid gamma ID

401

Invalid or missing credentials

403

Access denied

404

Gamma not found

get/v1.0/gammas/{gammaId}

HTTPcURLJavaScriptPython

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

{
  "id": "file_abc123",
  "title": "Q3 Marketing Strategy",
  "type": "regular",
  "url": "https://gamma.app/docs/Q3-Marketing-Strategy-abc123",
  "thumbnailUrl": "https://cdn.gamma.app/previews/abc123.png",
  "description": "A plan for Q3.",
  "author": {
    "name": "Jane Smith",
    "avatarUrl": "https://lh3.googleusercontent.com/a/photo.jpg"
  },
  "createdTime": "2026-04-23T16:24:33.000Z",
  "updatedTime": "2026-04-23T17:08:12.000Z",
  "themeId": "theme_abc123",
  "archived": false
}

Built for link-preview integrations such as Atlassian Smart Links and Notion Link Previews. Unlike archive and delete, this endpoint accepts either the API file ID (for example g_l0mf2jvf1fpmi1v) or the doc ID from a gamma.app/docs/... URL. Authenticate with X-API-KEY or an OAuth Bearer token.

Related

• GET /generations/{id} to retrieve the gammaId from a completed generation
• GET /gammas/{gammaId}/comments to list comment threads
• GET /gammas/{gammaId}/analytics for engagement metrics
• Connect integrations for partner integration setup
• Error codes for authentication and permission failures