Skip to content
Docs

Check if a cache artifact exists

HEADhttps://api.vercel.com/v8/artifacts/{hash}
Check that a cache artifact with the given hash exists. This request returns response headers only and is equivalent to a GET request to this endpoint where the response contains no body.
https://api.vercel.com/v8/artifacts/{hash}
const response = await fetch('https://api.vercel.com/v8/artifacts/hash?teamId=string&slug=string', {
  method: 'HEAD',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});


const data = await response.json();
console.log(data);
Response
{}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

hashstringRequired
The artifact hash

Query parameters

teamIdstringOptional
The Team identifier to perform the request on behalf of.
slugstringOptional
The Team slug to perform the request on behalf of.

Response

200The artifact was found and headers are returned

Errors

400One of the provided values in the request query is invalid.
401The request is not authorized.
402The account is missing a payment so payment method must be updated
403The customer has reached their spend cap limit and has been paused. An owner can disable the cap or raise the limit in settings. The Remote Caching usage limit has been reached for this account for this billing cycle. Remote Caching has been disabled for this team or user. An owner can enable it in the billing settings. You do not have permission to access this resource.
404The artifact was not found
410Error