Get an organization
One organization as the caller sees it, with their role and permissions. Organizations the caller may not see answer 404.
openapi/harthelm.yaml at v1.5.0__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.
org*stringuuidThe organization.
application/json- response
id*stringuuidname*stringrole?OrgRoleThe caller's role; absent when a cluster admin sees an organization they are not a member of.
"owner""member"created_at*stringdate-timedeleting?booleanThe organization is being deleted; it takes no writes. Absent for an older core.
delete_operation_id?stringThe org.delete operation of a deleting organization.
uuidpermissions?array<>The caller's permissions on the resource; the UI shows only what they allow. Absent for an older core.
curl -X GET 'https://console.example.com/api/v1/orgs/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "role": "owner", "created_at": "2019-08-24T14:15:22Z", "deleting": true, "delete_operation_id": "2a58cc5e-4ba9-418a-8f8b-9007f099696a", "permissions": [ "string" ]}Delete an organization
Organization owners and cluster admins (`org.manage`). Asynchronous and resumable, like a team's deletion: the organization turns `deleting` at once (it takes no writes: 409 `org-deleting`; its teams answer 409 `team-deleting`), and the operation `org.delete` (target `/orgs/<id>`) deletes each of its teams with the team cascade (workspaces purged at once, managed services, registries, domains, git access defaults, shared vaults, namespace), then the organization with its memberships and invitations. Audit rows stay. Every member loses access when the deletion starts. Deleting a deleting organization returns its operation. The console asks to type the organization's name first. The installation's default organization (`tenancy.defaultOrg`) can be deleted too; core creates it again, empty, at its next start. When a team's deletion gives up, the operation fails with the problem `org-delete-failed`, whose `failed_team` names the team and why; the organization stays `deleting` and nothing polls any more. Deleting it again is the *Retry*: it answers a new `org.delete` operation (`Org.delete_operation_id` changes), restarts the failed team deletions (each with a new `team.delete` operation) and resumes the organization's.
List organizations
The caller's organizations; cluster admins see every organization.