See how a hosted publish is going

GET
/v1/agents/{id}/versions/{version}/publish-status

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.

Authorization

apiKey
headerAuthorizationBearer <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.

Path Parameters

id*string

The agent id.

version*string

The version number, as the agent numbers its versions (1, 2, 3, …).

Response Body

Where the version stands

application/json
  1. response
status*
Example Request
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  }}