Vercel
Remote Cache API
Artifacts

Query artifact information

Query information about multiple artifacts by their hashes. Returns metadata about each artifact including size, task duration, and tag. This endpoint is optional for basic cache functionality but enables optimized cache fetching by allowing the client to query multiple artifacts in a single request.

POST
/artifacts

Authorization

bearerToken
AuthorizationBearer <token>

Bearer token authentication. Pass your authentication token in the Authorization header as Bearer <token>.

For self-hosted implementations, the token format and validation logic is up to the implementer. Common approaches include:

  • Static tokens for simple setups
  • JWT tokens for stateless authentication
  • OAuth2 tokens for integration with identity providers

In: header

Query Parameters

teamId?string

The team identifier to perform the request on behalf of. Used for multi-tenant cache implementations where artifacts are scoped to teams.

slug?string

The team slug to perform the request on behalf of. Alternative to teamId for identifying the team.

Request Body

application/json

hashes*array<string>

Array of artifact hashes to query

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://localhost:3000/artifacts" \  -H "Content-Type: application/json" \  -d '{    "hashes": [      "string"    ]  }'
{
  "property1": {
    "size": 0,
    "taskDurationMs": 0,
    "tag": "string"
  },
  "property2": {
    "size": 0,
    "taskDurationMs": 0,
    "tag": "string"
  }
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}