Get a credential to push an image
POST
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.
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.
application/json- body
agentId*stringThe agent whose repository the credential may push to.
Format
uuidA push credential for the agent's repository; the password is shown once
application/json- response
registry*stringLength
1 <= lengthrepository*stringLength
1 <= lengthusername*stringLength
1 <= lengthpassword*stringLength
1 <= lengthkeyId*stringLength
1 <= lengthexpiresAt*stringFormat
date-timecurl -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"}