Get explicit cache

GET/v1/cachedContents/{id}

Get metadata for a cache you own.

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

Authentication

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

Path Parameters

idstringrequired

The ID segment of the name returned at creation. Treat it as opaque.

Response

namestring

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

modelstring

Model name in models/{model} form.

displayNamestring

Display label, when returned.

createTimestring

Creation timestamp (RFC3339), when returned.

updateTimestring

Last update timestamp (RFC3339), when returned.

expireTimestring

Expiration timestamp (RFC3339), when returned.

usageMetadataobject

Cache usage information, when returned.

usageMetadata.totalTokenCountinteger

Number of cached tokens, when returned.

A missing or expired cache, or a cache belonging to another identity, returns 404. This operation requires access to the cache's model.

Request

Shell
1CACHE_NAME='cachedContents/0123456789abcdef0123456789abcdef'
2curl --fail-with-body "https://api.token360.ai/v1/$CACHE_NAME" \
3  -H "x-goog-api-key: $TOKEN360_API_KEY"

Response

JSON
1{
2  "name": "cachedContents/0123456789abcdef0123456789abcdef",
3  "model": "models/gemini-2.5-flash",
4  "displayName": "Reference document",
5  "createTime": "2026-11-06T10:00:00Z",
6  "updateTime": "2026-11-06T10:00:00Z",
7  "expireTime": "2026-11-06T11:00:00Z",
8  "usageMetadata": {
9    "totalTokenCount": 4096
10  }
11}
Was this page helpful?
Get explicit cache · Token360