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}

Path parameters

hashstring required

The artifact hash

Example:12HKQaOmR5t5Uy6vdcQsNIiZgHGB

The artifact hash

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Headers

Content-Lengthnumber required

The artifact size in bytes

The artifact size in bytes

x-artifact-durationnumber

The time taken to generate the uploaded artifact in milliseconds.

Example:400

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.

Example:VERCEL

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

x-artifact-client-interactiveinteger

1 if the client is an interactive shell. Otherwise 0

1 if the client is an interactive shell. Otherwise 0

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

Example:Tc0BmHvJYMIYJ62/zx87YqO0Flxk+5Ovip25NY825CQ=

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

x-artifact-shastring

The SHA of the source control revision that generated this artifact.

The SHA of the source control revision that generated this artifact.

x-artifact-dirty-hashstring

A hash representing uncommitted changes in the working directory when this artifact was generated.

A hash representing uncommitted changes in the working directory when this artifact was generated.

Response

File successfully uploaded

urlsstring[] required

Array of URLs where the artifact was updated

Example response

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

Changes