Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Body

application/json
provider
enum<string>
required

Registry provider. dockerhub for Docker Hub, ghcr for GitHub Container Registry, generic for any other OCI registry.

Available options:
ghcr,
dockerhub,
ecr,
generic
auth_kind
enum<string>
required

How Strix authenticates. none for public registries, basic_token for a username and token. For GitHub Container Registry, use a personal access token with the read:packages scope.

Available options:
basic_token,
aws_assume_role,
none
registry_host
string | null

Registry host for generic registries, for example registry.example.com. Optional for ghcr and dockerhub.

label
string | null

Display name for the connection. Defaults to the registry host.

username
string | null

Username for basic_token authentication.

secret
string | null

Token or password for basic_token authentication. Strix encrypts the value and never returns it.

Response

The connected registry.

registry
object
required

A connected container registry. The response never contains the stored credential.