---
title: "List owned workspace metadata"
method: GET
path: "/v1/workspaces"
tags: ["Workspaces"]
---

# List owned workspace metadata

`GET /v1/workspaces`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/workspaces`
- Auth: HTTP bearer

Returns a page ordered by workspace name and identifier. The default and maximum page size are 1000. Continue with next_cursor until it is empty. Saved workspaces remain visible after compute stops. Pages reflect current records and do not form a snapshot across concurrent changes.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Success

- object
  - `workspaces` WorkspaceRecord[], required
    - `id` string, required
    - `name` string, required
    - `size_gb` number, required
    - `holder_id` string, nullable
    - `saved_at` string, date-time, nullable
    - `expired_at` string, date-time, nullable: Time the tenant retention policy expired saved workspace state. The namespace remains listed.
    - `cleanup_pending` boolean: Expired workspace objects still require cleanup. An empty namespace can be reused after cleanup settles.
    - `stored_bytes` integer, nullable
    - `last_error` string
    - `saving_for_termination` boolean
    - `billing_status` 'disabled_no_approved_storage_rate' | 'metered_subject_to_account_limits' | 'included_workspace_storage' | 'account_workspace_storage' | 'ephemeral_instance', required: Storage billing policy for this record. ephemeral_instance has no saved storage or storage charge. Its compute session is billed separately.
  - `next_cursor` string: Opaque continuation for this account and list. Empty when this page has no further records.

## Other responses

- `default`: Error. The code, message, and fix fields describe the rejection and its remedy.

## Changes

- **2026-10-01** `ba84c74aeec8`: 1 warning, 5 info
  - added the new `ephemeral_instance` enum value to the `workspaces/items/billing_status` response property for the response status `200`
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the optional property `next_cursor` to the response with the `200` status
  - …2 more
- **2026-10-01** `544fef290a54`: 5 warning, 1 info
  - deleted the `query` request parameter `cursor`
  - deleted the `query` request parameter `limit`
  - removed the optional property `next_cursor` from the response with the `200` status
  - removed the optional property `workspaces/items/cleanup_pending` from the response with the `200` status
  - …2 more
- **2026-09-28** `5b5ed315c2a4`: 1 warning
  - added the new `ephemeral_instance` enum value to the `workspaces/items/billing_status` response property for the response status `200`
- **2026-09-28** `12e777b060de`: 1 info
  - removed the `ephemeral_instance` enum value from the `workspaces/items/billing_status` response property for the response status `200`
- **2026-09-27** `ed6520461760`: 1 warning
  - added the new `ephemeral_instance` enum value to the `workspaces/items/billing_status` response property for the response status `200`

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/workspaces/get.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)