# List an agent's builds

Source: https://docs.vlayers.ai/reference/hosting/list-agent-builds

`GET /v1/agents/{id}/builds` · scope `workspace:read`

The agent's builds, newest first, with the state, the limit or reason that ended each one, and for a success the image digest.

Requires an API key with the `workspace:read` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/builds" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { builds } = await voicelayer.hosting.listAgentBuilds('<agent-id>');
console.log(builds);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.list_agent_builds("<agent-id>")
print(result.builds)
```

## Response `200`

```json
{
  "builds": [
    {
      "id": "bd-0a1b2c3d4e5f60718293",
      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
      "snapshotId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",
      "state": "succeeded",
      "limit": null,
      "reason": null,
      "detail": null,
      "imageDigest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "builderDigest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "ecosystem": "node",
      "limits": {
        "cpuRequestMillicores": 500,
        "cpuMillicores": 2000,
        "memoryMiB": 4096,
        "diskMiB": 10240,
        "timeSeconds": 1800,
        "cacheExportSeconds": 600
      },
      "sizeClass": "small",
      "createdAt": "2026-10-20T15:04:05.000Z",
      "startedAt": "2026-10-20T15:04:05.000Z",
      "endedAt": "2026-10-20T15:04:05.000Z"
    }
  ]
}
```
