Skip to content
Aether Docs

Enable the organization's registry

POST
/api/v1/organizations/{orgID}/registry
curl --request POST \
  --url https://api.aetherplatform.cloud/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/registry \
  --header 'Authorization: Bearer <token>'

Provisions the org’s Harbor project and a default robot credential. No request body is required. The robot credentials are returned only in this response.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
orgID
required
string format: uuid

Organization UUID.

Responses

Section titled “Responses”

201

Section titled “201”

The enabled registry plus one-time robot credentials.

Media typeapplication/json
object
registry
required
object
id
required
string
org_id
required
string
harbor_project
required
string
endpoint
required
string
enabled
required
boolean
quota_gb
required
integer
used_gb
number | null format: double
created_at
required
string format: date-time
updated_at
required
string format: date-time
credentials
required
object
username
required

The Harbor robot username (e.g. robot$aether+org-).

string
password
required

The robot secret. Shown only once.

string
Examplegenerated
{
  "registry": {
    "id": "example",
    "org_id": "example",
    "harbor_project": "example",
    "endpoint": "example",
    "enabled": true,
    "quota_gb": 1,
    "used_gb": 1,
    "created_at": "2026-04-15T12:00:00Z",
    "updated_at": "2026-04-15T12:00:00Z"
  },
  "credentials": {
    "username": "example",
    "password": "example"
  }
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

404

Section titled “404”

The requested resource was not found.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

409

Section titled “409”

The resource already exists or conflicts with current state.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

503

Section titled “503”

A required backend dependency is unavailable.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}