---
title: "Changes to Upload a cache artifact"
method: PUT
path: "/v8/artifacts/{hash}"
---

# Changes to Upload a cache artifact

`PUT /v8/artifacts/{hash}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 137 revisions.

- **2026-09-30** `099fbe1f521c`: 1 info
- **2026-09-01** `606993b34ea5`: 1 breaking, 7 warning, 6 info
- **2026-07-21** `2ae10ee9d21c`: 1 info
- **2026-06-11** `14b4658f819e`: 5 warning, 7 info
- **2026-01-22** `c12186034433`: 1 breaking
- **2025-03-19** `37b482c58c92`: 1 info
- **2022-12-06** `8eb562567170`: 1 info

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-09-01** `606993b34ea5`: 1 breaking, 7 warning, 6 info
  - added the new required `header` request parameter `Content-Length`
  - deleted the `header` request parameter `'content-Length'`
  - deleted the `header` request parameter `'x-Artifact-Client-Ci'`
  - deleted the `header` request parameter `'x-Artifact-Client-Interactive'`
  - deleted the `header` request parameter `'x-Artifact-Dirty-Hash'`
  - deleted the `header` request parameter `'x-Artifact-Duration'`
  - deleted the `header` request parameter `'x-Artifact-Sha'`
  - deleted the `header` request parameter `'x-Artifact-Tag'`
  - added the new optional `header` request parameter `x-artifact-client-ci`
  - added the new optional `header` request parameter `x-artifact-client-interactive`
  - added the new optional `header` request parameter `x-artifact-dirty-hash`
  - added the new optional `header` request parameter `x-artifact-duration`
  - added the new optional `header` request parameter `x-artifact-sha`
  - added the new optional `header` request parameter `x-artifact-tag`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 5 warning, 7 info
  - deleted the `header` request parameter `Content-Length`
  - deleted the `header` request parameter `x-artifact-client-ci`
  - deleted the `header` request parameter `x-artifact-client-interactive`
  - deleted the `header` request parameter `x-artifact-duration`
  - deleted the `header` request parameter `x-artifact-tag`
  - added the new optional `header` request parameter `'content-Length'`
  - added the new optional `header` request parameter `'x-Artifact-Client-Ci'`
  - added the new optional `header` request parameter `'x-Artifact-Client-Interactive'`
  - added the new optional `header` request parameter `'x-Artifact-Dirty-Hash'`
  - added the new optional `header` request parameter `'x-Artifact-Duration'`
  - added the new optional `header` request parameter `'x-Artifact-Sha'`
  - added the new optional `header` request parameter `'x-Artifact-Tag'`
- **2026-01-22** `c12186034433`: 1 breaking
  - request body became required
- **2025-03-19** `37b482c58c92`: 1 info
  - added the new optional `query` request parameter `slug`
- **2022-12-06** `8eb562567170`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/vercel/apis/api/docs/v8/artifacts/:hash/put.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v8/artifacts/:hash/put)
