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

```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.","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"},"503":{"description":"Document search is temporarily unavailable"}},"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. A `503` means document search is temporarily unavailable; retry the request later.
{% 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 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/search-gammas.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.