Turborepo logo
Turborepo
Artifacts

Upload a cache artifact

Uploads a cache artifact identified by the `hash` specified on the path. The cache artifact can then be downloaded with the provided `hash`.

PUT
/v8/artifacts/{hash}

Authorization

AuthorizationRequiredBearer <token>

Default authentication mechanism

In: header

Request Body

application/octet-streamOptional
bodystring
Format: "binary"

Path Parameters

hashRequiredstring

The artifact hash

Query Parameters

teamIdstring

The Team identifier to perform the request on behalf of.

slugstring

The Team slug to perform the request on behalf of.

Header Parameters

Content-LengthRequirednumber

The artifact size in bytes

x-artifact-durationnumber

The time taken to generate the uploaded artifact in milliseconds.

x-artifact-client-cistring

The continuous integration or delivery environment where this artifact was generated.

Maximum length: 50
x-artifact-client-interactiveinteger

1 if the client is an interactive shell. Otherwise 0

Minimum: 0Maximum: 1
x-artifact-tagstring

The base64 encoded tag for this artifact. The value is sent back to clients when the artifact is downloaded as the header x-artifact-tag

Maximum length: 600
curl -X PUT "https://api.vercel.com/v8/artifacts/12HKQaOmR5t5Uy6vdcQsNIiZgHGB?teamId=string&slug=string" \
  -H "Content-Length: 0" \
  -H "x-artifact-duration: 400" \
  -H "x-artifact-client-ci: VERCEL" \
  -H "x-artifact-client-interactive: 0" \
  -H "x-artifact-tag: Tc0BmHvJYMIYJ62/zx87YqO0Flxk+5Ovip25NY825CQ=" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/octet-stream" \
  -d 'string'

File successfully uploaded

{
  "urls": [
    "https://api.vercel.com/v2/now/artifact/12HKQaOmR5t5Uy6vdcQsNIiZgHGB"
  ]
}

Previous

Get status of Remote Caching for this principal GET