#Admin

---

#GET /admin/orgs

List all organizations (super-admin)

Super-admin only. Cross-tenant org list with member/project counts. Excludes soft-deleted orgs.

Auth: Bearer token required

Responses

Status	Description	Schema
200	All organizations	AdminOrgList

---

#GET /admin/orgs/{id}

Get organization detail (super-admin)

Super-admin only. Org fields plus member and project lists.

Auth: Bearer token required

Path parameters

Name	Type	Description
id	string

Responses

Status	Description	Schema
200	Organization detail	AdminOrgDetail
404	Organization not found	Error

---

#POST /admin/orgs/{id}/suspend

Suspend an organization (super-admin)

Super-admin only. Sets suspended_at = now(). Idempotent. Audited in the same transaction.

Auth: Bearer token required

Path parameters

Name	Type	Description
id	string

Responses

Status	Description	Schema
200	Suspended	AdminOrgSuspendResult
404	Organization not found	Error

---

#POST /admin/orgs/{id}/unsuspend

Unsuspend an organization (super-admin)

Super-admin only. Clears suspended_at. Audited in the same transaction.

Auth: Bearer token required

Path parameters

Name	Type	Description
id	string

Responses

Status	Description	Schema
200	Unsuspended	AdminOrgSuspendResult
404	Organization not found	Error

---

#GET /admin/audit

List control-plane admin audit events

Super-admin only. Paginated, filterable list of control-plane (super-admin) audit events.

Auth: Bearer token required

Responses

Status	Description	Schema
200	Admin audit events	AdminAuditList

---

#GET /admin/metrics/overview

Control-plane metrics overview

Super-admin only. User/session/signup counts for the control-plane dashboard.

Auth: Bearer token required

Responses

Status	Description	Schema
200	Metrics overview	AdminMetricsOverview

---

#DELETE /admin/projects/{projectId}/nuke

Wipe a project's data (super-admin)

Super-admin only. Wipes all project-scoped runtime + catalog rows for the target project while preserving the project, members, repo links, tokens, and environments. Idempotent.

Auth: Bearer token required

Path parameters

Name	Type	Description
projectId	string

Responses

Status	Description	Schema
200	Deleted row counts by table	NukeResult

---

#GET /admin/integrations/github-installations

List all GitHub installations (super-admin)

Super-admin only. Cross-tenant list of every GitHub App installation. No pagination.

Auth: Bearer token required

Responses

Status	Description	Schema
200	All installations	AdminGithubInstallationList

#Schemas

#AdminAuditList

Field	Type	Description
data	object[]	(required)
total	integer	(required)
limit	integer	(required)
offset	integer	(required)

#AdminGithubInstallationList

Field	Type	Description
data	object[]	(required)

#AdminMetricsOverview

Field	Type	Description
totalUsers	integer	(required)
signups24h	integer	(required)
signups7d	integer	(required)
signups30d	integer	(required)
activeSessions	integer	(required)
mauApprox	integer	(required)

#AdminOrgDetail

Field	Type	Description
id	string	(required)
name	string	(required)
slug	string	(required)
members	object[]	(required)
projects	object[]	(required)

#AdminOrgList

Field	Type	Description
data	object[]	(required)

#AdminOrgSuspendResult

Field	Type	Description
id	string	(required)
suspendedAt	string | string | null	(required)

#Error

Field	Type	Description
error	string	(required)
code	string

#NukeResult

Field	Type	Description
projectId	string	(required)
rowCountsDeleted	object	(required)