v13

OpenAPI 3.0.32026-07-31359869.4 MB
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-Length'number

The artifact size in bytes

The artifact size in bytes

'x-Artifact-Duration'number

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-Ci'string

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-Interactive'integer

1 if the client is an interactive shell. Otherwise 0

1 if the client is an interactive shell. Otherwise 0

'x-Artifact-Tag'string

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-Sha'string

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-Hash'string

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"
  ]
}