---
title: "List workloads submitted from this workspace"
method: GET
path: "/v1/research-workspaces/{id}/workloads"
tags: ["Research workspaces"]
---

# List workloads submitted from this workspace

`GET /v1/research-workspaces/{id}/workloads`

## Request

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

Returns up to 100 admitted workloads, newest first, with the captured source revision. Recoverable pending_submissions preserve their exact original request and retry key for explicit resume after reconnecting. Old submissions without a stored request descriptor may be absent from pending_submissions. source_storage reports the separate included source pool. Use the ordinary workload endpoints for logs, results, costs and cancellation.

## Path parameters

- `id` string, required

## Response `200`

Admitted workspace workloads

- WorkspaceWorkloadList
  - `workloads` WorkspaceWorkload[], required
    - `id` string, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `source_revision` string, required: Digest identifying the immutable saved project revision used for this workload.
  - `pending_submissions` WorkspacePendingSubmission[]
    - `id` string, required
    - `workspace_id` string, required
    - `idempotency_key` string, required
    - `request` WorkspaceWorkloadRequest, required
      - `command` string, required: Command run from the captured project directory through the environment shell. Whitespace-only commands, NUL characters and commands longer than 8192 UTF-8 bytes are rejected.
      - `budget_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
      - `gpu` string: Optional GPU model override. Omit or send an empty string to inherit the workspace configuration.
      - `gpu_count` 0 | 1 | 2 | 4 | 8: Exact GPUs on one machine. Omitted or zero inherits the workspace configuration.
      - `gpu_memory_gb` number: Memory per GPU in GB. Omitted or zero inherits the workspace configuration.
    - `state` 'saving' | 'exporting' | 'cleanup_pending' | 'ready' | 'failed', required
    - `created_at` string, date-time, required
    - `deadline_at` string, date-time
    - `error` string
  - `source_storage` WorkspaceSourceStorage: Included account storage for generated workload source copies. This pool is separate from billed saved-workspace storage and ordinary asset import limits. Identical captured revisions reuse a physical copy. Reserved bytes can remain until pending writes or deletion are settled.
    - `included_bytes` integer, required: Included source retention limit. Currently 21,073,741,824 bytes, sufficient for two maximum workspace archives including bounded metadata.
    - `retained_bytes` integer, required
    - `reserved_bytes` integer, required
    - `available_bytes` integer, required
    - `billing_enabled` false, required
    - `cleanup_pending_bytes` integer: Bytes awaiting confirmed cleanup of uncertain source writes. Already included in reserved_bytes, not additional quota usage. A local observation timeout does not release them.

## Other responses

- `default`: 404 for a workspace outside this account. Authentication, rate limits and transient failures also apply.

## Changes

- **2026-10-01** `ba84c74aeec8`: 1 info
  - response property `pending_submissions/items/request/budget_usd` deprecated
- **2026-10-01** `544fef290a54`: 1 info
  - response property `pending_submissions/items/request/budget_usd` reactivated
- **2026-09-27** `dcc58d93c2cb`: 1 info
  - response property `pending_submissions/items/request/budget_usd` deprecated
- **2026-09-27** `90c4cb8514af`: 1 info
  - response property `pending_submissions/items/request/budget_usd` reactivated
- **2026-09-26** `fddd7d91a5a5`: 1 info
  - response property `pending_submissions/items/request/budget_usd` deprecated

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/research-workspaces/:id/workloads/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)