---
title: "Get Workspace Records"
method: GET
path: "/v2/workspace:listRecords"
tags: ["Workspaces"]
---

# Get Workspace Records

`GET /v2/workspace:listRecords`

List all workspace records the user has access to

## Query parameters

- `include_deleted` boolean — Include records that have been deleted
- `include_all` boolean — Include all records, even those the user does not have access to

## Response `200`

Successful Response

- WorkspaceRecordListResponse
  - `items` WorkspaceRecordResponse[], required
    - `id` string, int64, required
    - `created_at` string, date-time, required — The time at which the resource was created
    - `created_by` string, required — The ID of the user who created the resource
    - `updated_at` string, date-time, required — The time at which the resource was last updated
    - `updated_by` string, required — The ID of the user who last updated the resource
    - `name` string, required
    - `region` 'EU' | 'US', required
    - `region_api_url` string, uri, required — The regional API URL of the workspace.
    - `workos_org_id` string, nullable, required — WorkOS organization ID of the workspace. None if workos is not enabled or the workspace is not associated with a WorkOS organization.
    - `deleted_at` string, date-time, nullable, required
    - `deleted_by` string, nullable, required
  - `cursor` string, nullable, required — Cursor with which the next page of entries can be retrieved. If no cursor is returned, no further pages exist.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/cradle/apis/cradle-api.md) · [All operations](https://skmtc.dev/cradle/apis/cradle-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cradle/cradle-api/revisions/b0b5b6bfaed8/schema)