Skip to Content

Actions

The actions operations of the v1 API.

GET
/v1/actions/cache

Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.

The org cache: Actions cache and BuildKit cache usage, the free part, the limit and the monthly estimate. Only usage above the free part is billed.

Authorization

api_key
headerAuthorizationBearer <alc_ API key>

An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.

Response Body

Usage, limit and cost

application/json
  1. response

The org cache, as the public API shows it. Sizes in bytes (1 GB = 1e9), amounts in EUR.

actions_bytes*integer

Bytes of actions/cache entries.

Formatint64
build_cache_bytes*integer

Bytes of the BuildKit layer cache of the org's builds.

Formatint64
custom_limit*boolean

The org picked its own limit (otherwise the free amount).

demo*boolean

A demo organization: a fixed 1 GB limit, never billed.

free_bytes*integer

Never billed.

Formatint64
limit_bytes*integer

What the cache is held to; unused for 7 days or over it, the oldest items are removed.

Formatint64
limit_monthly_estimate*string

EUR a month with the cache filled to the limit.

max_bytes*integer

The highest limit the org may pick.

Formatint64
monthly_estimate*string

EUR a month at the current usage.

price_per_gb_month?|

EUR per GB-month above the free part; absent when unpriced.

total_bytes*integer

Both together: what the limit holds.

Formatint64
Example Request
curl 'https://api.a-line.cloud/v1/actions/cache' \  -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'
Example Response
{  "actions_bytes": 0,  "build_cache_bytes": 0,  "custom_limit": true,  "demo": true,  "free_bytes": 0,  "limit_bytes": 0,  "limit_monthly_estimate": "string",  "max_bytes": 0,  "monthly_estimate": "string",  "price_per_gb_month": "string",  "total_bytes": 0}
PATCH
/v1/actions/cache

Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.

Lowering it evicts the oldest items at once.

Authorization

api_key
headerAuthorizationBearer <alc_ API key>

An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.

Request Body

A new org cache limit.

application/json
  1. body

A new org cache limit.

cache_limit_gb*integer

Whole GB, at least the free amount and at most the max.

Formatint64

Response Body

The cache at the new limit

application/json
  1. response

The org cache, as the public API shows it. Sizes in bytes (1 GB = 1e9), amounts in EUR.

actions_bytes*integer

Bytes of actions/cache entries.

Formatint64
build_cache_bytes*integer

Bytes of the BuildKit layer cache of the org's builds.

Formatint64
custom_limit*boolean

The org picked its own limit (otherwise the free amount).

demo*boolean

A demo organization: a fixed 1 GB limit, never billed.

free_bytes*integer

Never billed.

Formatint64
limit_bytes*integer

What the cache is held to; unused for 7 days or over it, the oldest items are removed.

Formatint64
limit_monthly_estimate*string

EUR a month with the cache filled to the limit.

max_bytes*integer

The highest limit the org may pick.

Formatint64
monthly_estimate*string

EUR a month at the current usage.

price_per_gb_month?|

EUR per GB-month above the free part; absent when unpriced.

total_bytes*integer

Both together: what the limit holds.

Formatint64
Example Request
curl -X PATCH 'https://api.a-line.cloud/v1/actions/cache' \  -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \  -H 'Content-Type: application/json' \  -d '{"cache_limit_gb":1}'
Example Response
{  "actions_bytes": 0,  "build_cache_bytes": 0,  "custom_limit": true,  "demo": true,  "free_bytes": 0,  "limit_bytes": 0,  "limit_monthly_estimate": "string",  "max_bytes": 0,  "monthly_estimate": "string",  "price_per_gb_month": "string",  "total_bytes": 0}

On this page