Remove a user from a workspace or organization

POST

/workspaces/{workspace_gid}/removeUser

Workspaces

Remove a user from a workspace or organization.
The user making this call must be an admin in the workspace. The user can be referenced by their globally unique user ID or their email address.
Returns an empty data record.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/workspaces//removeUser' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "user": "12345"
    }
}'

Response Example

204 - Example 1

{
  "data": {}
}

Request

Path Params

workspace_gid

string

required

Body Params application/json

data

object (WorkspaceRemoveUserRequest)

optional

A user identification object for specification with the addUser/removeUser endpoints.

user

string

optional

A string identifying a user. This can either be the string "me", an email, or the gid of a user.

Example:

12345

Examples

Responses

🟢204The user was removed successfully to the workspace or organization.

application/json

Body

data

object (EmptyResponse)

optional

An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

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

Add a user to a workspace or organization

Get objects via typeahead