> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Organization Workspaces

Retrieve a list of workspaces in an organization, where each workspace is an Atlassian product instance accessed through a unique URL.

<Note>
  External Documentation

  To learn more, visit the [Atlassian Organizations documentation](https://developer.atlassian.com/cloud/admin/organization/rest/api-group-workspaces/#api-v2-orgs-orgid-workspaces-post).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                 |
  | ---------------- | --------------------------------------------------------------------------------------------------------------------------- |
  | Cursor           | A token used to specify a results page. This value can be obtained from the `links.next` property from a previous response. |
  | Limit            | The maximum number of workspaces to return per page. Maximum of `1000` workspaces can be returned.                          |
  | Organization ID  | The unique ID of your organization.<br /><br />Can be obtained by using the `List Organizations` action.                    |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                            |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Query     | A JSON query object to filter workspaces by.<br /><br />**Supports operators like:**<br />\* `and`<br />\* `nor`<br />\* `field`<br />\* `searchWorkspaces`<br />\* `features`<br />\* `policies`<br /><br />For more information about the Query parameter format refer to the [Atlassian Organizations documentation](https://developer.atlassian.com/cloud/admin/organization/rest/api-group-workspaces/#api-v2-orgs-orgid-workspaces-post-request-body) |
  | Sort      | A JSON array of sort fields to order the results.<br /><br />**For Example:**<br /><pre><code>\[<br />  \{<br />    "field":"attributes.name.raw",<br />    "order":"asc"<br />  }<br />]</code></pre>                                                                                                                                                                                                                                                      |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"id": "<string>",
			"type": "<string>",
			"attributes": {
				"name": "<string>",
				"typeKey": "<string>",
				"type": "<string>",
				"owner": "<string>",
				"status": "online",
				"statusDetails": [
					"<string>"
				],
				"icons": {},
				"avatars": {},
				"labels": [
					"<string>"
				],
				"sandbox": {
					"type": "CHILD"
				},
				"usage": 2154,
				"capacity": 2154,
				"createdAt": "<string>",
				"createdBy": "<string>",
				"updatedAt": "<string>",
				"hostUrl": "<string>",
				"realm": "<string>",
				"regions": [
					"<string>"
				]
			},
			"links": {
				"self": "<string>"
			},
			"relationships": {}
		}
	],
	"links": {
		"self": "<string>",
		"prev": "<string>",
		"next": "<string>"
	},
	"meta": {
		"pageSize": 2154,
		"startIndex": 2154,
		"endIndex": 2154,
		"total": 2154
	}
}
```

## Workflow Library Example

[List Organization Workspaces with Atlassian Organizations and Send Results Via Email](https://library.blinkops.com/workflows/list-organization-workspaces-with-atlassian-organizations-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-organization-workspaces-with-atlassian-organizations-and-send-results-via-email/canvas" />
</div>