POST
Create a container registry credential

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id
string

Workspace ID (uses default workspace if not provided)

Body

application/json

Create a container registry credential

name
string
required

Display name (must be unique within the workspace)

registry
enum<string>
required

Registry provider

Available options:
docker_hub,
github,
gitlab,
aws_ecr,
azure,
digitalocean,
quay,
generic
username
string
required

Registry username

token
string
required

Registry password or access token

registry_hostname
string

Registry hostname URL (required for 'generic', 'aws_ecr', and 'azure'; optional otherwise)

skip_validation
boolean

Skip live credential validation (non-production environments only)

Response

Create a container registry credential

Api_V1_Entities_ContainerRegistryCredential model

uuid
string
required

Unique credential identifier — pass this as deployment_config.credential_id when creating an app

name
string
required

Display name (unique per workspace)

registry
string
required

Registry provider: 'docker_hub', 'github', 'gitlab', 'aws_ecr', 'azure', 'digitalocean', 'quay', or 'generic'

username
string
required

Registry username

registry_hostname
string
required

Registry hostname (required for 'generic', 'aws_ecr', 'azure'; optional for others)

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp