# List run artifacts

> operationId: `listRunArtifacts`


## Request

This endpoint lists run artifacts. The path field is the absolute local path that the node actually wrote to (screenshots, downloads, Excel exports, saved data, and so on). The file stays where it is and is not copied or archived. If the file is later moved or deleted, the path value is still kept, so confirm that the file exists before you read it. The contentAvailable field is currently always false, and there is no download endpoint. The size field is in bytes and records the size at write time. A run has only one artifact record per path. When the same file is written again, the record keeps its original id, and size and createdAt are updated to the values from the last write.

- **Prerequisites**: You have obtained a run ID that you can read.
- **Authentication**: Same as the rest of the Local API; see [Authentication](/api-reference/getting-started/authentication). Resources belong to the current account/team data scope.
- **Side effects**: This call only reads metadata. It does not download or open files.
- **Completion signal**: 200 returns the array of artifact metadata in data.items. data.items=[] means that there are currently no public artifacts.
- **Retries**: Read-only calls can be retried. On 429 or 503, back off as indicated by Retry-After.


### Endpoint

```http
GET /api/rpa/browser/v1/runs/{runId}/artifacts
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs/{runId}/artifacts`. Use the port configured in the client.

### Headers

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `Authorization` | string | When Local API authentication is enabled | See [Authentication](/api-reference/getting-started/authentication). |


### Path parameters

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `runId` | string | Yes | ID of the run that the artifacts belong to. Min length 1; max length 128 |


### Query parameters

None.

### Request body

No request body.

### Request example

This is a documentation example; it was not sent to a live client. Set `RPA_BASE_URL` as described in [API conventions](/browser-rpa/api/common). Resource variables, the catalog revision, and ETags come from actual responses.

```bash
curl -i -X GET "${RPA_BASE_URL}/runs/${RPA_RUN_ID}/artifacts"
```

## Response

### 200

200 returns the array of artifact metadata in data.items. data.items=[] means that there are currently no public artifacts.

Body: `application/json`. The top-level `data` uses the model below. For `meta`, see [Metadata](/browser-rpa/api/data-types#metadata).

| Field | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `items` | array<[ArtifactMetadata](/browser-rpa/api/data-types#artifactmetadata)> | Yes | Array of entries on the current page or for the current resource. |


### Response example

All IDs, timestamps, hashes, and run results are sample data. They don't indicate that the sample was executed.

```json
{
  "data": {
    "items": [
      {
        "id": "artifact_example",
        "runId": "run_example",
        "name": "screenshot-1793318403000.png",
        "path": "/Users/example/Downloads/screenshot-1793318403000.png",
        "mimeType": "image/png",
        "size": 10240,
        "createdAt": 1793318403000,
        "contentAvailable": false
      }
    ]
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

### Error responses

For common 400/401/403/404/429/5xx errors and failure fields, see [Errors and recovery](/browser-rpa/api/common#errors-and-recovery). Error response example (403):

```json
{
  "error": {
    "code": "RPA_PERMISSION_DENIED",
    "message": "The request Host or Origin is not allowed, or the current identity can't access the target environment",
    "retryable": false,
    "issues": [],
    "details": null
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

## Related

[Local API reference](/browser-rpa/local-api) · [API conventions](/browser-rpa/api/common) · [Data models](/browser-rpa/api/data-types) · [Workflow structure](/browser-rpa/api/workflow) · [Quickstart](/browser-rpa/quickstart)