Turborepo Remote Cache API

This reference is the official Turborepo Remote Cache specification. The server implements every operation in it.

Send requests to https://<your server>/v8. Every operation needs the TURBO_TOKEN value as a bearer token. Artifacts are grouped by the teamId or slug query parameter, and requests without either use the team team_default_team. Errors return a JSON body with a code and a message.

The server answers browser requests to /v8 from any origin, so the Try it panel works against your own deployment. Enter its hostname in the server field.

artifacts

Operations for managing cache artifacts

• GET
  Get remote caching status/artifacts/status
• HEAD
  Check if artifact exists/artifacts/{hash}
• GET
  Download a cache artifact/artifacts/{hash}
• PUT
  Upload a cache artifact/artifacts/{hash}
• POST
  Query artifact information/artifacts

analytics

Operations for recording cache usage analytics

• POST
  Record cache usage events/artifacts/events