Registries

Create registry

Changed on

Adds a new private container registry. The secret is encrypted at rest using AES-256-GCM. Admin role required. Docker Hub, GHCR, and custom registries are available on every tier. Creating an AWS ECR registry requires an Admiral license. API tokens receive SCOPE_DENIED.

post/api/registries

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/registries
  • Auth
    HTTP bearer

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

Changes

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • warning

      added the new PAID_REQUIRED enum value to the response property for the response status

    • warning

      added the new PAID_REQUIRED enum value to the response property for the response status

    • warning

      added the new PAID_REQUIRED enum value to the response property for the response status

    • info

      removed the PRO_REQUIRED enum value from the response property for the response status

    • info

      removed the PRO_REQUIRED enum value from the response property for the response status

    • info

      removed the PRO_REQUIRED enum value from the response property for the response status