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 the200
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.
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
name | string | The name of the workspace. |
{
"gid": "12345",
"resource_type": "workspace",
"name": "My Company Workspace"
}
Workspace
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
name | string | The name of the workspace. |
email_domains | [string] | The email domains that are associated with this workspace. |
is_organization | boolean | Whether the workspace is an organization. |
{
"gid": "12345",
"resource_type": "workspace",
"name": "My Company Workspace",
"email_domains": [
"asana.com"
],
"is_organization": false
}