# Get

Launch stage: GA

`GET /api/environments/v1/{name=workspace-base-environments/*}`

Retrieves a WorkspaceBaseEnvironment by its name.

API scopes: environments

## Path parameters

- `name` (string, optional)
  Required. The resource name of the workspace base environment to retrieve.
   Format: workspace-base-environments/{workspace_base_environment}

## Returns

Returns the WorkspaceBaseEnvironment object.

## Response

```json
{
  "name": "string",
  "display_name": "string",
  "filepath": "string",
  "creator_user_id": "string",
  "create_time": "string",
  "last_updated_user_id": "string",
  "update_time": "string",
  "status": "string",
  "message": "string",
  "is_default": true,
  "base_environment_type": "string",
  "spec": {
    "dependencies": [
      "string"
    ],
    "environment_version": "5"
  }
}
```

