How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Gradle BuildCache API

Endpoints related to configuring the Build Cache nodes of the Develocity instance.To access these endpoints the user requires the `Configure Build Caching` permission.

Gradle BuildCache API is one of 9 APIs that Gradle publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Build Cache. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 3 paths, and defines 4 schemas. It is described by OpenAPI 3.2.0, at version 2026.2.0.

Requests are made against a single base URL, https://develocity.example.com.

4 operations 3 paths 4 schemas 1 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.2.0
Base URL
https://develocity.example.com/api
Authentication
HTTP Bearer
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Gradle BuildCache API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Bearer <>) (DevelocityAccessKeyOrToken). By default, every request must be authenticated.

  • DevelocityAccessKeyOrToken — All requests require a Develocity access key or token as a bearer token. Given an access key of l3an7wk3j4ze5v4mi7rvgjf2p7g44nvlswg4cpvdonjs7rzd4kmq, the requi…

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 1 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

BuildCache 4

Endpoints related to configuring the Build Cache nodes of the Develocity instance. To access these endpoints the user requires the Configure Build Caching permission.

GET
/api/build-cache/nodes/{name}
View the configuration of a Build Cache Node.
GetBuildCacheNode 1 param → 200404500
PUT
/api/build-cache/nodes/{name}
Create or update a Build Cache Node.
CreateOrUpdateBuildCacheNode 1 param body → 200201400404
POST
/api/build-cache/nodes/{name}/purge
Deletes all entries from a Build Cache Node.
InitiatePurgeOfBuildCacheNode 1 param → 202404500503
POST
/api/build-cache/nodes/{name}/secret
Regenerate the secret of a Build Cache Node.
RegenerateSecretOfBuildCacheNode 1 param → 200404500

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are ApiProblem (4 properties), NodeConfiguration (2 properties), ReplicationConfiguration (2 properties), KeySecretPair (2 properties). Each schema is shown below with its type and property counts.

KeySecretPair
object
A Build Cache Node key and secret pair.
2 properties 2 required
ApiProblem
object
Response detailing why a request was rejected. Adheres to the [RFC-7807](https://datatracker.ietf.org/doc/html/rfc7807) standard (colloquially known as "Proble…
4 properties 3 required
ReplicationConfiguration
objectnull
Cached data replication configuration description. May be null if replication is not configured.
2 properties 2 required
NodeConfiguration
object
A Build Cache Node configuration description.
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gradle-buildcache-api-openapi.yml Raw ↑

Other APIs Gradle publishes across the network.

Gradle Auth API
Gradle Builds API
Gradle Comparison API
Gradle Failures API
Gradle Meta API
Gradle Projects API
Gradle TestDistribution API
Gradle Tests API
Where this information came from

This is an independent, third-party profile of Gradle BuildCache API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.