Workspaces

Create a named persistent workspace

Changed on

Creates an empty tenant-owned workspace. A matching name and size replays the existing identity. Capacity and team count limits apply. Storage billing is disabled until an approved storage rate is configured.

post/v1/workspaces

Request

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

Request body

namestring required
size_gbnumber required

Requested capacity in GiB within the configured team limit.

Response

Success

idstring required
namestring required
size_gbnumber required
holder_idstring nullable
saved_atstring date-time nullable
expired_atstring date-time nullable

Time the tenant retention policy expired saved workspace state. The namespace remains listed.

cleanup_pendingboolean

Expired workspace objects still require cleanup. An empty namespace can be reused after cleanup settles.

stored_bytesinteger nullable
last_errorstring
saving_for_terminationboolean
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.

Changes

    • warning

      added the new ephemeral_instance enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      removed the ephemeral_instance enum value from the response property for the response status