> 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}

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":["template","regular"]},"url":{"type":"string","description":"Canonical URL to view the gamma"},"thumbnailUrl":{"type":"string","nullable":true,"description":"URL of a thumbnail image for the gamma, or null if unavailable"},"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.
{% endhint %}

## Related

* [GET /generations/{id}](/generations/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.