---
updatedAt: 2025-08-29T13:24:24.000Z
agentTools:
  projectIndex: https://docs.scalr.io/llms.txt
---

# scalr_workspaces

## Data Source: scalr\_workspaces

Retrieves a list of workspace ids by name or tags.

## Example Usage

```terraform
data "scalr_workspaces" "exact-names" {
  name = "in:production,development"
}

data "scalr_workspaces" "app-frontend" {
  name           = "like:app-frontend-"
  environment_id = "env-xxxxxxxxxx"
}

data "scalr_workspaces" "tagged" {
  tag_ids = ["tag-xxxxxxxxxx", "tag-xxxxxxxxxx"]
}

data "scalr_workspaces" "all" {
  environment_id = "env-xxxxxxxxxx"
}
```

## Schema

### Optional

* `account_id` (String) ID of the account, in the format `acc-<RANDOM STRING>`.
* `environment_id` (String) ID of the environment, in the format `env-<RANDOM STRING>`.
* `name` (String) The query used in a Scalr workspace name filter.
* `tag_ids` (Set of String) List of tag IDs associated with the workspace.

### Read-Only

* `id` (String) The ID of this resource.
* `ids` (List of String) The list of workspace IDs, in the format \[`ws-xxxxxxxxxxx`, `ws-yyyyyyyyy`].

# Sibling pages

* [scalr\_endpoint](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_endpoint.md)
* [scalr\_access\_policy](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_access_policy.md)
* [scalr\_agent\_pool](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_agent_pool.md)
* [scalr\_assume\_service\_account\_policy](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_assume_service_account_policy.md)
* [scalr\_current\_account](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_current_account.md)
* [scalr\_current\_run](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_current_run.md)
* [scalr\_environment](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_environment.md)
* [scalr\_environments](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_environments.md)
* [scalr\_event\_bridge\_integration](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_event_bridge_integration.md)
* [scalr\_hook](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_hook.md)
* [scalr\_iam\_team](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_iam_team.md)
* [scalr\_iam\_user](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_iam_user.md)
* [scalr\_integration\_infracost](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_integration_infracost.md)
* [scalr\_module\_namespace](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_module_namespace.md)
* [scalr\_module\_version](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_module_version.md)
* [scalr\_module\_versions](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_module_versions.md)
* [scalr\_outputs](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_outputs.md)
* [scalr\_policy\_group](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_policy_group.md)
* [scalr\_provider\_configuration](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_provider_configuration.md)
* [scalr\_provider\_configurations](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_provider_configurations.md)
* [scalr\_role](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_role.md)
* [scalr\_service\_account](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_service_account.md)
* [scalr\_ssh\_key](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_ssh_key.md)
* [scalr\_storage\_profile](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_storage_profile.md)
* [scalr\_tag](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_tag.md)
* [scalr\_var\_set](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_var_set.md)
* [scalr\_variable](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_variable.md)
* [scalr\_variables](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_variables.md)
* [scalr\_vcs\_provider](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_vcs_provider.md)
* [scalr\_webhook](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_webhook.md)
* [scalr\_workload\_identity\_provider](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_workload_identity_provider.md)
* [scalr\_workspace](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_workspace.md)
* [scalr\_workspace\_ids](https://docs.scalr.io/scalr/docs/provider_datasource_scalr_workspace_ids.md)