> 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/search-gammas.md).

# GET /gammas/search

Full-text search over gammas the caller can access, matched against titles and body text.

Search workspace gammas by title and body text, with optional filters for author and last-updated time.

## Search gammas

> Full-text search over the gammas the caller can access, matched against titles and body text. When a query is provided, results are relevance-ranked. When no query is provided (an empty query with at least one filter), results are ordered by last-updated descending. Search is being rolled out gradually and may not yet be available to all accounts. If you receive a 403, it means access hasn't been enabled for you yet.

```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":{"SearchGammasResponse":{"type":"object","properties":{"hits":{"description":"Array of hits, relevance-ranked when a query is provided and ordered by\nlast-updated descending otherwise","type":"array","items":{"$ref":"#/components/schemas/GammaSearchHit"}}},"required":["hits"]},"GammaSearchHit":{"type":"object","properties":{"id":{"type":"string","description":"Unique gamma identifier"},"title":{"type":"string","nullable":true,"description":"Gamma title, or null if untitled"},"url":{"type":"string","description":"URL to view the gamma"},"highlight":{"type":"string","nullable":true,"description":"Query-centered snippet from the gamma's text, or null when no snippet is\navailable (e.g. filter-only browse)"},"createdBy":{"type":"string","nullable":true,"description":"Display name of the gamma's creator, or null if unavailable"},"updatedTime":{"type":"string","nullable":true,"description":"ISO-8601 timestamp of when the gamma was last modified"},"archived":{"type":"boolean","description":"True when the hit is an archived gamma (only possible with\nincludeArchived)"}},"required":["id","title","url","highlight","createdBy","updatedTime","archived"]}}},"paths":{"/v1.0/gammas/search":{"get":{"description":"Full-text search over the gammas the caller can access, matched against titles and body text. When a query is provided, results are relevance-ranked. When no query is provided (an empty query with at least one filter), results are ordered by last-updated descending. Search is being rolled out gradually and may not yet be available to all accounts. If you receive a 403, it means access hasn't been enabled for you yet.","operationId":"searchGammas","parameters":[{"name":"q","required":false,"in":"query","description":"Full-text search query matched against gamma titles and body text.\nOptional when at least one filter (createdBy, updatedAfter, updatedBefore)\nis set.","schema":{"type":"string"}},{"name":"createdBy","required":false,"in":"query","description":"Restrict results to gammas created by this user: 'me', an email address,\nor a user ID.","schema":{"type":"string"}},{"name":"updatedAfter","required":false,"in":"query","description":"ISO-8601 lower bound (inclusive) on the gamma's last-updated time.","schema":{"type":"string"}},{"name":"updatedBefore","required":false,"in":"query","description":"ISO-8601 upper bound (inclusive) on the gamma's last-updated time.","schema":{"type":"string"}},{"name":"includeArchived","required":false,"in":"query","description":"When true, archived gammas are included in results. Defaults to false.","schema":{"type":"boolean"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of hits to return (1-25)","schema":{"minimum":1,"maximum":25,"type":"number"}}],"responses":{"200":{"description":"Search results retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGammasResponse"}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Invalid or missing credentials"},"403":{"description":"Search is not enabled for this workspace yet. Reach out to support@gamma.app to get it enabled."}},"summary":"Search gammas","tags":["public-api"]}}}}
```

{% hint style="info" %}
Supports `X-API-KEY` or OAuth Bearer token. When `q` is set, results are relevance-ranked; with filters only, results sort by last-updated descending. Use `limit` (1–25) to cap hits. Search is rolling out gradually — a `403` means it is not enabled for your workspace yet; contact <support@gamma.app>.
{% endhint %}

## Related

* [GET /gammas/{gammaId}](/management/get-gamma.md) to fetch metadata for a single hit
* [GET /themes](/workspace/list-themes.md) and [GET /folders](/workspace/list-folders.md) for other workspace browse endpoints
* [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/search-gammas.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.