---
seo:
  description: >-
    This reference is the official Turborepo Remote Cache specification. The
    server implements every operation in it.
sidebar:
  label: Overview
title: 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.

Version 1.0.0

Base URL: `https://{host}/v8`

## artifacts

Operations for managing cache artifacts

- [`GET /artifacts/status`](/api/artifacts/get-artifact-status) — Get remote caching status.
- [`HEAD /artifacts/{hash}`](/api/artifacts/artifact-exists) — Check if artifact exists.
- [`GET /artifacts/{hash}`](/api/artifacts/download-artifact) — Download a cache artifact.
- [`PUT /artifacts/{hash}`](/api/artifacts/upload-artifact) — Upload a cache artifact.
- [`POST /artifacts`](/api/artifacts/query-artifacts) — Query artifact information.

## analytics

Operations for recording cache usage analytics

- [`POST /artifacts/events`](/api/analytics/record-cache-events) — Record cache usage events.