Build Cache Applications

Get the Build Cache

GET /v1/applications/{uuid}/build-cache

Read an application's build cache: the packages its production builds downloaded (npm, pnpm or Yarn), kept so the next build doesn't download them again. Branch and pull request previews use it but never change it. See Build cache for how it works.

It needs read access to applications. An app whose builds don't use the cache (a managed backend, a function, a WordPress site) answers exists: false.

Path parameters

uuid string (uuid)

The application.

Response (200 OK)

exists boolean

true when the app has a build cache. false when no production build has saved one yet, or since it was cleared, started fresh or deleted.

component string

static: the build of a static site or of a full-stack app's front end.

size_bytes integer

The cache's size. 0 when there is none.

saved_at string? (RFC 3339)

When a production build saved it. null when there is none.

package_manager string

The package manager whose downloads it holds: npm, pnpm or yarn. "" when there is none.

Errors

403 Forbidden

Your role can't read applications, or your plan has no application hosting.

404 Not Found

application not found

Request
curl "https://api.ngris.com/v1/applications/019be838-d261-7d9b-9499-71995a3a91c6/build-cache" \
  -H "X-API-KEY: <your_api_key>"

Response — 200 OK
{
  "exists": true,
  "component": "static",
  "size_bytes": 222298112,
  "saved_at": "2026-11-03T09:00:00Z",
  "package_manager": "npm"
}

Response — 200 OK, no cache
{
  "exists": false,
  "component": "static",
  "size_bytes": 0,
  "saved_at": null,
  "package_manager": ""
}

Clear the Build Cache

DELETE /v1/applications/{uuid}/build-cache

Clear an application's build cache. The next production build downloads every package again and saves a new cache, so it takes longer. A build that had already started keeps the cache it started with. The live version doesn't change.

It needs a role that can change applications. Clearing an app that has no cache also answers 204, so you can repeat it safely. It works while the app is paused.

Path parameters

uuid string (uuid)

The application.

Response (204 No Content)

No body.

Errors

403 Forbidden

Your role can't change applications, or your plan has no application hosting.

404 Not Found

application not found

Request
curl -X DELETE "https://api.ngris.com/v1/applications/019be838-d261-7d9b-9499-71995a3a91c6/build-cache" \
  -H "X-API-KEY: <your_api_key>"

Response — 204 No Content
HTTP/1.1 204 No Content

Was this helpful?

PreviousBuild Log NextRuntime Log

On this page

Get the Build Cache Clear the Build Cache

Was this helpful?