---
title: "Fetch an offloaded screenshot (PNG) by content-addressed id"
method: GET
path: "/api/v1/runs/{id}/screenshots/{artifactId}"
tags: ["Screenshots"]
---

# Fetch an offloaded screenshot (PNG) by content-addressed id

`GET /api/v1/runs/{id}/screenshots/{artifactId}`

## Request

- Base URL: `https://dungbeetle.dev`
- URL: `https://dungbeetle.dev/api/v1/runs/{id}/screenshots/{artifactId}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Serves the PNG bytes for a `screenshotRefs` artifact id from a run's report. Content-addressed, so cacheable immutably. Requires the `runs:read` scope on agent tokens.

## Path parameters

- `id` string, required
- `artifactId` string, required: sha-256 hex digest (content-addressed artifact id).

## Response `200`

PNG bytes.

## Other responses

- `400`: Invalid body or parameter (`code: validation_error`), or — on screenshot upload — a body that does not hash to the digest (`code: digest_mismatch`).
- `401`: Missing/malformed Authorization header (`code: unauthorized`), bad Basic credentials (`code: invalid_credentials`), or an invalid, expired, or revoked agent token (`code: invalid_agent_token`).
- `403`: Agent token outside its granted scopes (`code: missing_scope`, with a `scope` field naming the required scope) or a route that is not agent-accessible at all (`code: agent_forbidden`). Basic-auth requests never see this.
- `404`: No such resource in this repository (`code: not_found`).
- `429`: Too many failed attempts or uploads from this client (`code: rate_limited`). Honor the `Retry-After` header; successful authenticated requests never count toward the limit.

---

[API](https://skmtc.dev/dungbeetle/apis/dungbeetle-cloud-api.md) · [All operations](https://skmtc.dev/dungbeetle/apis/dungbeetle-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dungbeetle/apis/dungbeetle-cloud-api/revisions/74778b90420a?raw)