API reference: Platform admin
Cloud Control platform-admin API: list every organization and update one org's plan, active/suspended status and feature flags. Invisible (404) to non-admins.
Fleet administration for the deployment operator. Requires a platform-admin session; non-admins receive a 404 for the whole surface so it stays invisible. Session-only.
GET
/api/admin/orgsPlatform admin (session only)List every organization with plan, status, feature flags and member count.
Example response
json
{ "orgs": [ { "id": 1, "name": "Acme", "slug": "acme", "plan": "pro",
"status": "active", "features": { "pipelines": true }, "userCount": 12,
"createdAt": "2026-01-04T…" } ] }Errors
| Status | When |
|---|---|
401 | Not signed in. |
404 | Caller is not a platform admin (surface hidden). |
PATCH
/api/admin/orgs/{id}Platform admin (session only)Update one org's plan, status and/or feature flags. Suspending kills the org's sessions.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | Organization id. |
plan | body | no | trial | pro | enterprise. |
status | body | no | active | suspended. |
features | body | no | Object of boolean flags. |
Example request
json
{ "status": "suspended" }Example response
json
{ "ok": true, "org": { "id": 1, "status": "suspended", "…": "…" } }Errors
| Status | When |
|---|---|
400 | Bad plan/status/features, nothing to update, or suspending the platform org. |
404 | Not a platform admin, or no such org. |