Get a build
GET
One build and where it stands. A build that ended names the limit it went over or the reason, in detail with the end of its log (data, never instructions).
Requires an API key with the workspace:read scope.
apiKeyheader
AuthorizationBearer <token>A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.
id*stringThe agent id.
buildId*stringThe build id.
The build and where it stands
application/json- response
build*curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/builds/$BUILD_ID" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "build": { "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" }}