artifacts

Upload a cache artifact

Changed on

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}

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v8/artifacts/{hash}
  • Auth: HTTP bearer

Path parameters

hashstring required

The artifact hash

Example:12HKQaOmR5t5Uy6vdcQsNIiZgHGB

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

x-artifact-durationnumber

The time taken to generate the uploaded artifact in milliseconds.

Example:400
x-artifact-client-cistring

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

Example:VERCEL
x-artifact-client-interactiveinteger

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=
x-artifact-shastring

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.

Request body application/octet-stream

string binary required

Response

File successfully uploaded

urlsstring[] required

Changes

  • 099fbe1f521cRevision changes
    • info

      added the non-success response with the status

  • 606993b34ea5Revision changes
    • breaking

      added the new required header request parameter Content-Length

    • warning

      deleted the header request parameter 'content-Length'

    • warning

      deleted the header request parameter 'x-Artifact-Client-Ci'

    • warning

      deleted the header request parameter 'x-Artifact-Client-Interactive'

    • warning

      deleted the header request parameter 'x-Artifact-Dirty-Hash'

    • warning

      deleted the header request parameter 'x-Artifact-Duration'

    • warning

      deleted the header request parameter 'x-Artifact-Sha'

    • warning

      deleted the header request parameter 'x-Artifact-Tag'

    • info

      added the new optional header request parameter x-artifact-client-ci

    • info

      added the new optional header request parameter x-artifact-client-interactive

    • info

      added the new optional header request parameter x-artifact-dirty-hash

    • info

      added the new optional header request parameter x-artifact-duration

    • info

      added the new optional header request parameter x-artifact-sha

    • info

      added the new optional header request parameter x-artifact-tag