v34

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-018932140.9 KB
Registries

Create registry

Adds a new private container registry. The secret is encrypted at rest using AES-256-GCM. Requires Admiral license and admin role. API tokens receive SCOPE_DENIED.

post/api/registries

Request body

namestring required
urlstring required
type'dockerhub' | 'ghcr' | 'ecr' | 'custom' required
usernamestring required
secretstring required

Password, token, or access key. Write-only — never returned in GET responses.

aws_regionstring

Required when type is ecr.

Example request

{
  "name": "GitHub Container Registry",
  "url": "ghcr.io",
  "username": "my-user",
  "aws_region": "us-east-1"
}

Response

Registry created.

idinteger required