Get a credential to push an image

POST
/v1/hosting/registry-credentials

Mints a short-lived credential for pushing container images to one agent's repository in VoiceLayer's registry; voicelayer deploy calls it for you. The credential lasts an hour, opens that repository and nothing else, and cannot place calls. The password is shown once.

Requires an API key with the workspace:write 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.

Request Body

application/json
  1. body
agentId*string

The agent whose repository the credential may push to.

Formatuuid

Response Body

A push credential for the agent's repository; the password is shown once

application/json
  1. response
registry*string
Length1 <= length
repository*string
Length1 <= length
username*string
Length1 <= length
password*string
Length1 <= length
keyId*string
Length1 <= length
expiresAt*string
Formatdate-time
Example Request
curl -X POST https://api.vlayers.ai/v1/hosting/registry-credentials \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"  }'
Example Response
{  "registry": "registry.vlayers.ai",  "repository": "0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",  "username": "vlayers",  "password": "<shown once>",  "keyId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",  "expiresAt": "2026-10-20T15:04:05.000Z"}