---
title: "List Gemini cached content"
method: GET
path: "/v1beta/cachedContents"
tags: ["Gemini Resources"]
---

# List Gemini cached content

`GET /v1beta/cachedContents`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1beta/cachedContents`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-goog-api-key`

Lists cached content belonging to the current Workspace. Use nextPageToken to continue. Resources can only be read, referenced, changed, or deleted in their owning Workspace. Missing, expired, or inaccessible resources return a Gemini-format error.

## Query parameters

- `key` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Success

- object
  - `cachedContents` GeminiCachedContentResource[], required
    - `name` string: Resource name such as cachedContents/{cacheId}.
    - `model` string: TokenLab model ID associated with the cached content.
    - `displayName` string: Human-readable cache name.
    - `createTime` string, date-time
    - `updateTime` string, date-time
    - `expireTime` string, date-time
    - `usageMetadata` object
  - `nextPageToken` string

## Other responses

- `400`: Gemini-format resource error
- `401`: Gemini-format resource error
- `403`: Gemini-format resource error
- `404`: Gemini-format resource error
- `409`: Gemini-format resource error
- `429`: Gemini-format resource error
- `502`: Gemini-format resource error
- `503`: Gemini-format resource error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)