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

get

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.

Authorizations

X-API-KEYstringRequired

API key for authentication

Query parameters

qstringOptional

Full-text search query matched against gamma titles and body text. Optional when at least one filter (createdBy, updatedAfter, updatedBefore) is set.

Example: climate analytics

createdBystringOptional

Restrict results to gammas created by this user: 'me', an email address, or a user ID.

Example: me

updatedAfterstringOptional

ISO-8601 lower bound (inclusive) on the gamma's last-updated time.

Example: 2026-06-01

updatedBeforestringOptional

ISO-8601 upper bound (inclusive) on the gamma's last-updated time.

Example: 2026-08-01

includeArchivedbooleanOptional

When true, archived gammas are included in results. Defaults to false.

Example: false

limitnumber · min: 1 · max: 25Optional

Maximum number of hits to return (1-25)

Example: 10

Responses

200

Search results retrieved successfully

application/json

400

Invalid query parameters

401

Invalid or missing credentials

403

Search is not enabled for this workspace yet. Reach out to [e-mail] to get it enabled.

get/v1.0/gammas/search

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

{
  "hits": [
    {
      "id": "abc123def456",
      "title": "Climate analytics pitch",
      "url": "https://gamma.app/docs/Climate-analytics-pitch-abc123",
      "highlight": "...the climate analytics market grew...",
      "createdBy": "Jane Doe",
      "updatedTime": "2026-08-02T17:08:12.000Z",
      "archived": false
    }
  ]
}

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 [e-mail].

Related

• GET /gammas/{gammaId} to fetch metadata for a single hit
• GET /themes and GET /folders for other workspace browse endpoints
• Error codes for authentication and permission failures