CentralCSP
APIWorkspaces

Transfer workspace ownership

Hands ownership to another member of the workspace, who is promoted to admin. You stay an admin and lose the owner-only permissions.

Requires workspace ownership.

POST
/v1/workspaces/{workspaceId}/transfer

Authorization

headerAuthorizationBearer <JWT>

An OpenID Connect access token from signing in to CentralCSP, acting as the signed-in user.

Path Parameters

workspaceId*string

The workspace's id.

Request Body

application/json
  1. body
newOwnerId*string

The userId of the member who becomes the owner. They must already be a member of the workspace.

Length1 <= length

Response Body

A workspace.

application/json
  1. response
id*string

Unique identifier of the workspace.

name*string

Display name.

ownerId*string

User who owns the workspace. The owner can do everything, including transferring ownership and deleting the workspace.

requiresMfa*boolean

When true, a member without two-factor authentication is refused on every workspace endpoint until they enrol.

disableAiIntegrations*boolean

When true, AI tools cannot reach this workspace.

plan*|

The plan of the current subscription, or null when the workspace has no active subscription and cannot collect reports.

role*|

Your role in this workspace, or null when you own it without being a member.

createdAt*string

When the workspace was created.

Formatdate-time
updatedAt*string

When the workspace was last changed.

Formatdate-time
Example Request
curl -X POST 'https://api.centralcsp.com/v1/workspaces/01936b7a-6f2e-7c31-9a4d-2f8e1c5b7d90/transfer' \  -H 'Content-Type: application/json' \  -d '{  "newOwnerId": "string"}'
Example Response
{  "id": "string",  "name": "Acme",  "ownerId": "string",  "requiresMfa": true,  "disableAiIntegrations": true,  "plan": {    "slug": "pro",    "name": "Pro",    "features": [      "compliance",      "alerting",      "api_keys"    ]  },  "role": "admin",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Delete a workspace DELETE

Deletes the workspace, its websites, members, and collected reports, and cancels its subscription. Report ingestion for its websites stops immediately.

Set AI tool access PUT

Turns AI tool access to this workspace off, or back on. While it is off, AI tools connected to any member's account get 403 on this workspace.