v34

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

Update registry

Updates an existing registry. All fields are optional — only provided fields are changed. Requires Admiral license and admin role. API tokens receive SCOPE_DENIED.

put/api/registries/{id}

Path parameters

idinteger required

Numeric resource ID.

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 updated.

successboolean required

Example response

{
  "success": true
}