Drop every cached layer in this service's cache namespace

DELETE

/cache

• Local Faber instance

Clears the local tier and, with a shared backend, every key in the configured CACHE_NAMESPACE, so it affects all nodes sharing it.

Authorizations

• apiKey

Responses

200

Cleared

object

cleared

required

Number of cached layers removed (best effort for shared backends)

integer

401

Missing or wrong API key (unauthorized)

object

error

required

Human-readable message

string

code

required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string

Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error

Example

{
  "error": "Missing or invalid API key",
  "code": "unauthorized"
}

Headers

WWW-Authenticate

string

409

The cache is disabled on this service (cache_disabled)

object

error

required

Human-readable message

string

code

required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string

Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error

Example

{
  "error": "The step cache is disabled on this service",
  "code": "cache_disabled"
}

429

The API key has used up its requests (rate_limited). Sent only when the service enables per-key rate limiting (RATE_LIMIT_PER_MINUTE). Retry after the Retry-After header.

object

error

required

Human-readable message

string

code

required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string

Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error

Example

{
  "error": "Rate limit exceeded for this API key",
  "code": "rate_limited"
}

Headers

Retry-After

integer

Seconds until the key may make another request