curl --request PATCH \
--url https://cockroachlabs.cloud/api/v1/virtual-cluster-workspaces/{workspace_id} \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--json '{"default_virtual_cpu_burst_limit":8,"name":"production"}'{
"cloud_provider": "AWS",
"created_at": "2026-03-22T20:23:11.285067Z",
"default_virtual_cpu_burst_limit": 4,
"id": "35c4abb2-bb66-46d7-afed-25ebef5ed2aa",
"name": "production",
"regions": [
"us-east-1",
"us-west-2"
],
"updated_at": "2026-04-01T09:14:02.114930Z"
}{
"code": 123,
"details": [
{
"@type": "<string>"
}
],
"message": "<string>"
}Update the configuration of a specific workspace
Can be used by the following roles assigned at the organization, folder or cluster scope:
- CLUSTER_ADMIN
- CLUSTER_OPERATOR_WRITER
Changes to a workspace’s configuration apply only to virtual clusters created after the change, not to virtual clusters that already exist. To modify existing virtual clusters, see CockroachCloud_UpdateVirtualCluster.
The role must be assigned on the host cluster backing the workspace, not on the workspace itself.
curl --request PATCH \
--url https://cockroachlabs.cloud/api/v1/virtual-cluster-workspaces/{workspace_id} \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--json '{"default_virtual_cpu_burst_limit":8,"name":"production"}'{
"cloud_provider": "AWS",
"created_at": "2026-03-22T20:23:11.285067Z",
"default_virtual_cpu_burst_limit": 4,
"id": "35c4abb2-bb66-46d7-afed-25ebef5ed2aa",
"name": "production",
"regions": [
"us-east-1",
"us-west-2"
],
"updated_at": "2026-04-01T09:14:02.114930Z"
}{
"code": 123,
"details": [
{
"@type": "<string>"
}
],
"message": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the workspace.
Body
The changes to apply to the workspace.
Response
A successful response.
A workspace is a named handle for the infrastructure a set of virtual clusters runs on.
- GCP: The Google Cloud Platform cloud provider.
- AWS: The Amazon Web Services cloud provider.
- AZURE: The Azure cloud provider.
GCP, AWS, AZURE The date and time the workspace was created.
The vCPU burst limit a virtual cluster gets when its create request does not ask for a specific one. Changing this value in a workspace does not affect clusters that already exist in the workspace, only newly created clusters.
The unique identifier of the workspace.
The name of the workspace.
The regions the workspace spans. A virtual cluster created into it may use any subset of these and no others.
The date and time the workspace was last modified.