Update cache expiration
/v1/cachedContents/{id}Update a cache’s expiration. Other fields cannot be changed.
/v1 is the default version; equivalent /v1beta paths remain supported.
Authentication
Send your Token360 API key in x-goog-api-key.
Path Parameters
idstringrequiredThe ID segment of the name returned at creation. Treat it as opaque.
Query Parameters
updateMaskstringOptional expiration mask: ttl, expireTime, or expire_time. Use the mask matching the supplied expiration field.
Request Body
ttlstringNew lifetime in seconds, greater than zero and at most 86400s. Mutually exclusive with expireTime.
expireTimestringNew future RFC3339 expiration timestamp, at most 24 hours from now. Mutually exclusive with ttl.
Supply exactly one expiration field. ttl is measured from the update request, not added to the previous expiration. Renew before the cache expires; updating cannot recreate expired content.
Response
namestringCache resource name: cachedContents/{id}. Save it for subsequent operations.
modelstringModel name in models/{model} form.
displayNamestringDisplay label, when returned.
createTimestringCreation timestamp (RFC3339), when returned.
updateTimestringLast update timestamp (RFC3339), when returned.
expireTimestringExpiration timestamp (RFC3339), when returned.
usageMetadataobjectCache usage information, when returned.
usageMetadata.totalTokenCountintegerNumber of cached tokens, when returned.
Requires content-retention permission. A concurrent update or a cache unavailable for this operation returns 409. After an uncertain update outcome, retrieve the cache metadata before deciding whether another update is needed.