Workspaces

Workspaces allow you to represent different products or business lines that have different compliance requirements. Each Workspace can have its own Frameworks and Controls. The help docs have more information on how create and manage Workspaces.

List Workspaces

🔒 Requires Workspaces: List Workspaces permission.

Securitybearer
Request
query Parameters
cursor
string

This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a pagination.cursor value that can be used in the subsequent request to retrieve the next page of results

size
number [ 1 .. 50 ]
Default: 20

Number of results to return

sort
string (SortTypeLimitedEnum)

Which field to sort by

Enum: "createdAt" "updatedAt"
sortDir
string (SortDirectionEnum)

The direction to sort the data

Enum: "ASC" "DESC"
expand[]
Array of strings (WorkspaceExpandEnum)

List of subcollections and sub-objects to expand

Items Value: "frameworks"
Responses
200

Successful

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/workspaces
Request samples 
Response samples 
application/json
{
  • "data": [
    • {
      • "id": 1,
      • "primary": false,
      • "name": "Drata Automation",
      • "description": "Drata automates SOC 2 compliance",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z",
      • "howItWorks": "Connect your systems to the Drata Autopilot system and sit back and relax!",
      • "url": "https://drata.com",
      • "logo": "https://cdn-prod.imgpilot.com/logo.png",
      • "frameworks": [
        • {
          • "id": 13,
          • "name": "NIST AI RMF",
          • "description": "The NIST AI Risk Management Framework (AI RMF) is a set of suggestions and guidelines for incorporating trustworthiness considerations in the design, development, deployment, and use of AI systems.",
          • "createdAt": "2025-07-01T16:45:55.246Z",
          • "updatedAt": "2025-07-01T16:45:55.246Z",
          • "enabledAt": "2025-07-01T16:45:55.246Z"
          }
        ]
      }
    ],
  • "pagination": {
    • "cursor": "string"
    }
}