Harthelm Docs
REST APIRegistries

List the team's container registries

Credentials for private images of `container` services, ordered by name. Passwords are never returned. Needs `team.view`.

Generated from openapi/harthelm.yaml at v1.5.0
GET
/teams/{team}/registries

Authorization

cookie__Host-harthelm_session<token>

Browser session of the UI (12 h idle, 7 days absolute). State-changing requests also need the header Harthelm-CSRF: 1 and a matching Origin.

Path Parameters

team*integer

Numeric resource id.

Formatint64
Range1 <= value

Query Parameters

limit?integer

Maximum number of items per page.

Range1 <= value <= 200
Default50
cursor?string

Opaque cursor from next_cursor of the previous page.

Lengthlength <= 1024

Response Body

A page of registries.

application/json
  1. response
next_cursor?string

Absent on the last page.

items*array<>
curl -X GET 'https://console.example.com/api/v1/teams/1/registries'
{  "next_cursor": "string",  "items": [    {      "id": 1,      "team_id": 1,      "name": "string",      "address": "string",      "username": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

Remove a container registry

Team admins (`team.manage`). The pull Secrets of running services lose these credentials at their workspace's next reconcile (pods that are running keep their image); the next Plan resolves their images without them.

Change a container registry

Team admins (`team.manage`). Absent fields stay; an absent `password` keeps the stored one, except that an `address` on another host needs the `password` again (422 at `/password`): the stored password only ever goes to the host it was entered for. The pull Secrets of running services follow at their workspace's next reconcile; the digests stay what their last Sync resolved.