---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Build caches"
description: "The `build_caches` collection of Sylphx Build: A BuildCache is a per-project layer cache."
type: reference
product: builds
summary: "A BuildCache is a per-project layer cache."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

A BuildCache is a per-project layer cache. It makes builds faster and never changes their result; a missing or unreachable cache only slows a build.

**Service** Sylphx Build · **Resource type** `build.sylphx.com/BuildCache` · **Name pattern** `orgs/{org}/projects/{project}/build_caches/{build_cache}` · **Shape** `spec_status`

**Not available yet.** Sylphx Build is declared in the registry but no backend serves it: every call answers `501` with the problem code `UNIMPLEMENTED`.

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/build_caches/{build_cache}`. |
| `uid` | `string` | `bch_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `BuildCacheSpec` | Desired state. Required. |
| `status` | `BuildCacheStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/build_caches#get) | Gets a build cache. |
| `GET` | [`list`](/docs/api/build_caches#list) | Lists build caches in a project. |
| `PATCH` | [`update`](/docs/api/build_caches#update) | Updates a build cache. |
| `DELETE` | [`delete`](/docs/api/build_caches#delete) | Deletes a build cache. |

## get

Gets a build cache.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/build_caches/build-cache` · scope `build:read` · effect `read` · not available yet · [Request, response and examples](/docs/api/build_caches/get)

## list

Lists build caches in a project.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/build_caches` · scope `build:read` · effect `read` · not available yet · paginated · [Request, response and examples](/docs/api/build_caches/list)

## update

Updates a build cache.

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/build_caches/build-cache` · scope `build:write` · effect `write` · not available yet · [Request, response and examples](/docs/api/build_caches/update)

## delete

Deletes a build cache.

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/build_caches/build-cache` · scope `build:write` · effect `destructive` · not available yet · [Request, response and examples](/docs/api/build_caches/delete)