Workspaces

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

An organization is a special kind of workspace that represents a company. In an organization, you can group your projects into teams. You can read more about how organizations work in the Asana Guide.

📘

Workspace or organization?

To tell if your workspace is an organization or not, check its is_organization property. For an example, see the 200 response for getting a workspace.

Over time, we intend to migrate most workspaces into organizations and to release more organization-specific functionality. We may eventually deprecate using workspace-based APIs for organizations. Currently, and until after some reasonable grace period following any further announcements, you can still reference organizations in any workspace parameter.


WorkspaceCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the workspace.
{
  "gid": "12345",
  "resource_type": "workspace",
  "name": "My Company Workspace"
}

Workspace

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the workspace.
email_domains[string]The email domains that are associated with this workspace.
is_organizationbooleanWhether the workspace is an organization.
{
  "gid": "12345",
  "resource_type": "workspace",
  "name": "My Company Workspace",
  "email_domains": [
    "asana.com"
  ],
  "is_organization": false
}