> For the complete documentation index, see [llms.txt](https://developers.gamma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gamma.app/management/get-gamma.md).

# 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

> 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).

```json
{"openapi":"3.0.0","info":{"title":"Gamma Public API","version":"1.0"},"tags":[{"name":"public-api","description":"Public API endpoints for external integrations"}],"servers":[{"url":"https://public-api.gamma.app","description":"Production"}],"security":[{"api-key":[]},{"bearer":[]}],"components":{"securitySchemes":{"api-key":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication"},"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"OAuth bearer token for authentication"}},"schemas":{"GetGammaResponse":{"type":"object","properties":{"id":{"type":"string","description":"Unique gamma identifier (file ID)"},"title":{"type":"string","description":"Gamma title"},"type":{"type":"string","description":"Gamma type: 'template' or 'regular'","enum":["regular","template"]},"url":{"type":"string","description":"Canonical URL to view the gamma"},"thumbnailUrl":{"type":"string","nullable":true,"description":"Screenshot URL, or null if unavailable. Usually signed so it loads without a Gamma session; a signed URL expires after about 7 days, so re-fetch it rather than storing it."},"description":{"type":"string","nullable":true,"description":"Description or preview text for the gamma, or null if unavailable"},"author":{"nullable":true,"description":"Author of the gamma, or null if unavailable","type":"object","allOf":[{"$ref":"#/components/schemas/GammaAuthor"}]},"createdTime":{"type":"string","nullable":true,"description":"ISO-8601 timestamp of when the gamma was created, or null if unavailable"},"updatedTime":{"type":"string","nullable":true,"description":"ISO-8601 timestamp of when the gamma was last modified, or null if unavailable"},"themeId":{"type":"string","nullable":true,"description":"ID of the theme applied to the gamma, or null if no theme is set"},"archived":{"type":"boolean","description":"Whether the gamma is archived"}},"required":["id","title","type","url","thumbnailUrl","description","author","createdTime","updatedTime","themeId","archived"]},"GammaAuthor":{"type":"object","properties":{"name":{"type":"string","description":"Display name of the author"},"avatarUrl":{"type":"string","nullable":true,"description":"URL of the author's avatar image, or null if not set"}},"required":["name","avatarUrl"]}}},"paths":{"/v1.0/gammas/{gammaId}":{"get":{"description":"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).","operationId":"getGamma","parameters":[{"name":"gammaId","required":true,"in":"path","description":"The gamma file ID or the doc ID from the gamma.app/docs/... URL","schema":{"minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$","type":"string"}}],"responses":{"200":{"description":"Gamma metadata retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetGammaResponse"}}}},"400":{"description":"Invalid gamma ID"},"401":{"description":"Invalid or missing credentials"},"403":{"description":"Access denied"},"404":{"description":"Gamma not found"}},"summary":"Get gamma metadata","tags":["public-api"]}}}}
```

{% hint style="info" %}
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. When present, `thumbnailUrl` is a signed screenshot URL that usually loads without a Gamma session; it expires after about 7 days, so re-fetch this endpoint rather than storing the URL long term.
{% endhint %}

## Related

* [GET /generations/{id}](/generations-classic/get-generation-status.md) to retrieve the `gammaId` from a completed generation
* [GET /gammas/{gammaId}/comments](/management/get-gamma-comments.md) to list comment threads
* [GET /gammas/{gammaId}/analytics](/analytics/get-gamma-analytics.md) for engagement metrics
* [Connect integrations](/connectors/connectors-and-integrations.md) for partner integration setup
* [Error codes](/reference/error-codes.md) for authentication and permission failures


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.gamma.app/management/get-gamma.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
