---
search:
  tags:
    - artifacts
    - POST
seo:
  description: >-
    Query information about multiple artifacts by their hashes. Returns
    metadata… Reference for the POST /artifacts endpoint in the Turborepo Remote
    Cache API.
sidebar:
  label: Query artifact information
  badge: POST
title: Query artifact information
type: openapi-operation
---
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`

**Request body** (`application/json`, required)

- `hashes` (string[], required) — Array of artifact hashes to query

Request body example:

```json
{
  "hashes": [
    "string"
  ]
}
```

**Responses**

- `200` — Artifact information retrieved successfully
- `400` — Bad request. One or more of the provided values in the request query, headers, or body is invalid.
- `401` — Unauthorized. The request is missing a valid authentication token or the token is invalid.
- `403` — Forbidden. The authenticated user does not have permission to access this resource.

Response example, 200:

```json
{
  "property1": {
    "size": 0,
    "taskDurationMs": 0,
    "tag": "string"
  },
  "property2": {
    "size": 0,
    "taskDurationMs": 0,
    "tag": "string"
  }
}
```