# Read build artifact

Download the immutable application output as application/gzip (tar.gz), capped at 64 MiB. Returns 409 until ready. The archive contains regular files only; paths are relative and checked.

`GET /api/platform/v1/apps/{appId}/builds/{buildId}/artifact`

Required permission: `project:read`.

## Parameters

| Name | In | Type | Required | Description |

| --- | --- | --- | --- | --- |

| `appId` | path | `string` | Yes | — |

| `buildId` | path | `string` | Yes | — |

## Example request

```bash
curl --request GET \
  --url https://api.hoplite.sh/api/platform/v1/apps/appId/builds/buildId/artifact \
  --header "X-Api-Key: $HOPLITE_API_KEY"
```

## 200 response

Success

Content type: `application/gzip`. Response type: `string<binary>`.

```text

```

## Status codes

- `200` — Success

- `400` — Invalid request

- `401` — Authentication required

- `403` — Permission, app scope or entitlement denied

- `404` — App, source or thread not found

- `409` — Idempotency conflict or request in progress

- `413` — Request too large

- `503` — Source storage or execution unavailable