CentralCSP
APIWorkspaces

List workspaces

Lists every workspace you belong to, newest first, with your role in each and the features of its plan. When you call from an AI tool, workspaces that have turned AI tool access off are left out.

GET
/v1/workspaces

Authorization

headerAuthorizationBearer <JWT>

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

Query Parameters

cursor?string

The nextCursor of the previous page. Omit it to start from the beginning. A cursor encodes a position and is not meant to be built by hand.

limit*|

How many items to return, from 1 to 200.

Range1 <= value <= 200
Default50
q?string

Match part of the name.

Response Body

A page of workspaces.

application/json
  1. response
data*array<>

The workspaces on this page.

pagination*

Where this page sits in the full result set.

Example Request
curl -X GET 'https://api.centralcsp.com/v1/workspaces?limit=50'
Example Response
{  "data": [    {      "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"    }  ],  "pagination": {    "nextCursor": "string",    "hasMore": true,    "total": 0  }}

Claim a custom subdomain PATCH

Moves the website's reporting endpoint to a subdomain of your choice, for example shop.reports.centralcsp.com, and returns the website with its new...

Create a workspace POST

Creates a workspace with you as its owner and first admin. A new workspace has no subscription, so choose a plan before it can collect reports.