Create a registry

Add new container registry credentials to a namespace

POST

/auth/v1/seed/{namespace}/registries

curl --request POST \
  --url /auth/v1/seed/{namespace}/registries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"github-registry","registry_url":"ghcr.io","username":"acme-bot","password":"ghp_a1b2c3d4e5f6g7h8i9j0"}'

Add new container registry credentials to a namespace. The password is encrypted at rest and never returned in API responses.

Path parameters

namespace

string

required

The namespace (user or organization) to add the registry to.

Body parameters

name

string

required

A display name for the registry credential (e.g., `github-registry`, `aws-ecr-prod`).

registry_url

string

required

The registry hostname. For example, `"ghcr.io"`, `"docker.io"`, `"123456789.dkr.ecr.us-east-1.amazonaws.com"`.

username

string

required

The username for authenticating with the registry.

password

string

required

The password or access token for authenticating with the registry. Encrypted at rest and never returned in responses.

Previous → Delete a git provider

Next List registries →