---
title: upload_artifact
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/caching/upload_artifact
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/caching/upload_artifact"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/caching
  - /docs/agent-resources/vercel-mcp/tools
related:
  []
summary: Use upload_artifact with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# upload_artifact

Upload a cache artifact.

## Parameters

| Parameter                    | Type    | Required | Description                                                                                                                                |
| ---------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `contentLength`              | number  | No       | The artifact size in bytes                                                                                                                 |
| `xArtifactDuration`          | number  | No       | The time taken to generate the uploaded artifact in milliseconds.                                                                          |
| `xArtifactClientCi`          | string  | No       | The continuous integration or delivery environment where this artifact was generated.                                                      |
| `xArtifactClientInteractive` | integer | No       | 1 if the client is an interactive shell. Otherwise 0                                                                                       |
| `xArtifactTag`               | string  | No       | 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` |
| `xArtifactSha`               | string  | No       | The SHA of the source control revision that generated this artifact.                                                                       |
| `xArtifactDirtyHash`         | string  | No       | A hash representing uncommitted changes in the working directory when this artifact was generated.                                         |
| `hash`                       | string  | Yes      | The artifact hash                                                                                                                          |
| `teamId`                     | string  | No       | Team ID.                                                                                                                                   |
| `slug`                       | string  | No       | Team slug.                                                                                                                                 |
| `requestBody`                | string  | Yes      | Provide this binary value as a base64 string.                                                                                              |


---

[View full sitemap](/docs/sitemap)