See how a hosted publish is going
GET
Says where a submitted version stands: waiting for its first room to register, published, or failed with the room's own words and the tail of its logs. Each call also moves the version along, so polling it every few seconds is how voicelayer deploy waits.
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.
version*stringThe version number, as the agent numbers its versions (1, 2, 3, …).
Where the version stands
application/json- response
status*curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/versions/$VERSION/publish-status" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "status": { "version": 3, "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012", "state": "published", "image": { "digest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef", "repository": "registry.vlayers.ai/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "workspaceId": "0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45", "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "pushedAt": "2026-10-20T15:04:05.000Z", "sizeBytes": 148000000, "platform": "linux/amd64", "scan": { "status": "complete", "scanner": "trivy", "scannedAt": "2026-10-20T15:04:05.000Z", "findings": { "critical": 0, "high": 1, "medium": 4, "low": 9, "unknown": 0 }, "reportRef": null, "error": null }, "sbom": { "format": "spdx-json", "ref": "sbom/0123456789ab.json" }, "referencedBy": 1 }, "rooms": [ { "id": "room_0192f5d4-8b9c-7dae-8f3a-4b5c6d7e8f90", "state": "ready", "stateChangedAt": "2026-10-20T15:04:05.000Z" } ], "failure": null }}