# Update the default workspace base environment configuration

Launch stage: GA

`PATCH /api/environments/v1/{name=default-workspace-base-environment}`

Updates the default WorkspaceBaseEnvironment configuration for the workspace.
 Sets the specified base environments as the workspace defaults for CPU and/or GPU compute.

API scopes: environments

## Path parameters

- `name` (string, required, ID, Immutable)
  The resource name of this singleton resource.
   Format: default-workspace-base-environment

## Query parameters

- `update_mask` (string, required)
  Field mask specifying which fields to update. Use comma as the separator for multiple fields (no space). 
   The special value '*' indicates that all fields should be updated (full replacement).
   Valid field paths: cpu_workspace_base_environment, gpu_workspace_base_environment
  
   To unset one or both defaults, include the field path(s) in the mask and omit them from the request body.
   To unset both, you must list both paths explicitly — the wildcard '*' cannot be used to unset fields.

## Request body

Required. The default workspace base environment configuration to update.
- `cpu_workspace_base_environment` (string, optional)
  The default workspace base environment for CPU compute.
   Format: workspace-base-environments/{workspace_base_environment}
- `gpu_workspace_base_environment` (string, optional)
  The default workspace base environment for GPU compute.
   Format: workspace-base-environments/{workspace_base_environment}

## Returns

Returns the DefaultWorkspaceBaseEnvironment object.

## Response

```json
{
  "name": "string",
  "cpu_workspace_base_environment": "string",
  "gpu_workspace_base_environment": "string"
}
```