---
title: "Get recent workspaces"
method: GET
path: "/workspaces/recent"
tags: ["Workspaces"]
---

# Get recent workspaces

`GET /workspaces/recent`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/workspaces/recent`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Query parameters

- `limit` number, nullable
- `direction` 'older' | 'newer'
- `date` number

## Response `200`

- RecentWorkspacesResponse
  - `user_workspace_ids` string[], required: List of workspaces user is part of.
  - `recent_workspace_changes` RecentWorkspaces[], required
    - `workspace_id` string, required
    - `workspace_name` string, required
    - `last_updated_ts` number, required
    - `deleted_at_ts` number
    - `users` RecentUser[], required
      - `user_id` string, required
      - `last_updated_ts` number, required
      - `status` 'active' | 'user_left' | 'removed_from_channel' | 'removed_from_workspace', required
      - `status_changed_ts` number, required

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)