Get users in a workspace or organization

GET

/workspaces/{workspace_gid}/users

Returns the compact records for all users in the specified workspace or organization.
Results are sorted alphabetically and limited to 2000. For more results use the /users endpoint.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "data": [
        {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        }
    ]
}

Request

Path Params

workspace_gid

string

required

Responses

🟢200Return the users in the specified workspace or org.

application/json

Body

data

array[object (UserCompact) {3}]

optional

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

Read-only except when same user as requester. The user’s name.

Example:

Greg Sanchez

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

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

Get a user's favorites

Get time periods