Workspaces

List an organization’s workspaces (API keys see only their project)

get/v1/organizations/{organization_id}/workspaces

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/organizations/{organization_id}/workspaces
  • Auth: HTTP bearer

Path parameters

organization_idstring uuid required

UUIDv7, lowercase canonical form.

Query parameters

limitinteger
cursorstring
project_idstring uuid

UUIDv7, lowercase canonical form.

state'creating' | 'starting' | 'running' | 'suspending' | 'suspended' | 'resuming' | 'forking' | 'stopping' | 'failed' | 'deleting' | 'deleted'

Observed state filter.

desired_state'running' | 'suspended' | 'deleted'
key_prefixstring
labelsstring

JSON object of exact label matches; all pairs must match.

include_deletedboolean
lifetime'persistent' | 'session' | 'any'

persistent (default), session or any. Key lookups pass any.

purpose'standard' | 'template_draft' | 'template_test' | 'any'

standard (default), template_draft, template_test or any. Key lookups pass any.

Response

Default Response

next_cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.