Workspaces

Switch computer use on or off for the workspace

enabled: true or false overrides the template’s switch; null follows it. While computer use is on, tool tokens carry the computer tool and the workspace desktop starts on the first computer call. Takes effect on the next tool token. 409 computer_use_unavailable when the workspace’s template version cannot run a desktop, 409 not_supported_for_mode for file-first workspaces, 409 workspace_deleted. Returns the switch.

put/v1/workspaces/{workspace_id}/computer-use

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/workspaces/{workspace_id}/computer-use
  • Auth: HTTP bearer

Path parameters

workspace_idstring uuid required

UUIDv7, lowercase canonical form.

Request body

enabledboolean nullable required

true or false overrides the template; null follows it.

Response

Default Response

enabledboolean required

Effective: tool tokens carry the computer tool (the workspace’s value, else the template’s, and the version runs a desktop).

workspaceboolean nullable required

The workspace’s own value; null follows the template.

templateboolean required

The template’s switch for its workspaces.

availableboolean required

The workspace’s template version can run a desktop (its guest agent has desktop.v1).

Changes

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