List explicit caches

GET/v1/cachedContents

List caches you own and can access.

/v1 is the default version; equivalent /v1beta paths remain supported.

Authentication

Send your Token360 API key in x-goog-api-key.

Query Parameters

pageSizeinteger

Maximum page size, from 1 to 100. Default: 100. Fewer caches may be returned.

pageTokenstring

Opaque nextPageToken from the previous response. Omit for the first page.

Response

cachedContentsobject[]

Cache metadata visible on this page. No cached prompt contents are returned.

cachedContents.namestring

Cache resource name: cachedContents/{id}. Save it for subsequent operations.

cachedContents.modelstring

Model name in models/{model} form.

cachedContents.displayNamestring

Display label, when returned.

cachedContents.createTimestring

Creation timestamp (RFC3339), when returned.

cachedContents.updateTimestring

Last update timestamp (RFC3339), when returned.

cachedContents.expireTimestring

Expiration timestamp (RFC3339), when returned.

cachedContents.usageMetadataobject

Cache usage information, when returned.

nextPageTokenstring

Continuation token, omitted when there are no more pages.

Solicitar

Shell
1curl --fail-with-body --get 'https://api.token360.ai/v1/cachedContents' \
2  -H "x-goog-api-key: $TOKEN360_API_KEY" \
3  --data-urlencode 'pageSize=20'
4# Subsequent pages: also pass --data-urlencode "pageToken=$NEXT_PAGE_TOKEN"

Respuesta

JSON
1{
2  "cachedContents": [
3    {
4      "name": "cachedContents/0123456789abcdef0123456789abcdef",
5      "model": "models/gemini-2.5-flash",
6      "displayName": "Reference document",
7      "createTime": "2026-11-06T10:00:00Z",
8      "updateTime": "2026-11-06T10:00:00Z",
9      "expireTime": "2026-11-06T11:00:00Z",
10      "usageMetadata": {
11        "totalTokenCount": 4096
12      }
13    }
14  ]
15}
¿Ha sido de ayuda?
List explicit caches · Token360