Documentation menu
These are pre-release docs from the main branch.

API reference

6 operations in portal-admin. Raw spec: openapi.json.

GET/api/v1/clients/{id}/board-exposures

GET /api/clients/{id}/board-exposures — every configured row for the client (exposed or not), so admin UI can render toggles.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

StatusDescription
200

Security: bearer

PUT/api/v1/clients/{id}/board-exposures

PUT /api/clients/{id}/board-exposures — upsert one board×client row.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request body

PutExposureRequest

Responses

StatusDescription
200
404board or client missing

Security: bearer

GET/api/v1/clients/{id}/portal-users

GET /api/clients/{id}/portal-users — directory for one client.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

StatusDescription
200

Security: bearer

POST/api/v1/clients/{id}/portal-users

POST /api/clients/{id}/portal-users — provision (invite) one identity.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request body

CreatePortalUserRequest

Responses

StatusDescription
200
409email already provisioned

Security: bearer

PATCH/api/v1/portal-users/{id}

PATCH /api/portal-users/{id} — rename / re-tier / enable / disable / reset password.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request body

PatchPortalUserRequest

Responses

StatusDescription
200
404

Security: bearer

DELETE/api/v1/portal-users/{id}

DELETE /api/portal-users/{id} — hard removal (sessions cascade). Prefer PATCH status=disabled to preserve history.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

StatusDescription
200
404

Security: bearer