Update a workspace

PUT

/workspaces/{workspace_gid}

Workspaces

A specific, existing workspace can be updated by making a PUT request on the URL for that workspace. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged.
Currently the only field that can be modified for a workspace is its name.
Returns the complete, updated workspace record.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://app.asana.com/api/1.0/workspaces/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "name": "My Company Workspace"
    }
}'

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

Body Params application/json

data

object (WorkspaceCompact)

optional

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

name

string

optional

The name of the workspace.

Example:

My Company Workspace

Examples

Responses

🟢200Update for the workspace was successful.

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 a workspace

Add a user to a workspace or organization