Skip to content
forgit api docs

Get GitHub Actions cache retention limit for an enterprise

GET
/enterprises/{enterprise}/actions/cache/retention-limit

Gets GitHub Actions cache retention limit for an enterprise. All organizations and repositories under this enterprise may not set a higher cache retention limit.

OAuth tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

API method documentation

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
enterprise
required
string

The slug version of the enterprise name.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Response

Media type application/json
Actions cache retention limit for an enterprise

GitHub Actions cache retention policy for an enterprise.

object
max_cache_retention_days

For repositories & organizations in an enterprise, the maximum duration, in days, for which caches in a repository may be retained.

integer
Examples
Example default 
{
  "max_cache_retention_days": 80
}

403

Section titled “ 403 ”

Forbidden

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

404

Section titled “ 404 ”

Resource not found

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}