Get a workspace

GET

/workspaces/{workspace_gid}

Returns the full workspace record for a single workspace.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/workspaces/'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "My Company Workspace",
        "email_domains": [
            "asana.com"
        ],
        "is_organization": false
    }
}

Request

Path Params

workspace_gid

string

required

Responses

🟢200Return the full workspace record.

application/json

Body

data

object (WorkspaceResponse)

optional

A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.

email_domains

array[string <uri>]

optional

The email domains that are associated with this workspace.

Example:

["asana.com"]

is_organization

boolean

optional

Whether the workspace is an organization.

Example:

false

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

name

string

optional

The name of the workspace.

Example:

My Company Workspace

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:32

Get multiple workspaces

Update a workspace