Skip to main content
POST
/
projects
/
{projectId}
/
oci-registries
cURL
curl --request POST \
  --url {schemes}://api.upsun.com/projects/{projectId}/oci-registries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "registry": "<string>",
  "auth": {
    "username": "<string>",
    "password": "<string>"
  },
  "identity_token": "<string>",
  "registry_token": "<string>"
}
'
{
  "status": "<string>",
  "code": 123
}

Documentation Index

Fetch the complete documentation index at: https://developer.upsun.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId
string
required

Body

application/json
registry
string
required

Registry hostname with optional port and optional path namespace, e.g. 'ghcr.io', 'registry.example.com:5000', 'quay.io/myorg' (no scheme, no trailing slash, lowercase only)

auth
Basic Auth · object

Basic Auth for the container registry

identity_token
string | null

Refresh token to exchange for bearer token with container registry auth

registry_token
string | null

Bearer token used to auth with container registry auth

Response

default - application/json
status
string
required

The status text of the response

code
integer
required

The status code of the response

Last modified on May 29, 2026