Skip to content

List users in workspace

GET
/api/v1/users

List users in a workspace with pagination.

Returns a paginated list of users in the specified workspace.

Args: workspace: Workspace GID (required). limit: Number of items per page (1-100, default 100). offset: Pagination cursor from previous response.

Returns: List of users with pagination metadata.

workspace
required
Workspace

Workspace GID to list users from

string

Workspace GID to list users from

limit
Limit

Number of items per page

integer
default: 100 >= 1 <= 100

Number of items per page

offset
Any of:
string

Pagination cursor from previous response

Successful Response

SuccessResponse[list[AsanaResource]]
object
data
required
Data

Response data payload

Array<object>
AsanaResource

Base Asana resource returned by the Asana API.

All Asana resources share a gid and resource_type. Additional fields vary by endpoint and the opt_fields parameter. The extra=“allow” config accepts any additional fields without declaring them, which avoids the circular $ref problem that dict[str, Any] causes in the generated OpenAPI schema.

Attributes: gid: Globally unique identifier for the Asana resource. resource_type: Resource type string (e.g., “task”, “project”). name: Display name of the resource (optional, depends on opt_fields).

object
gid
required
Gid

Globally unique Asana resource identifier

string
resource_type
Any of:
string
name
Any of:
string
key
additional properties
any
meta
required
ResponseMeta

Response metadata

object
request_id
required
Request Id

Request correlation ID

string
>= 1 characters
timestamp
Timestamp

Response timestamp (UTC)

string format: date-time
pagination
Any of:
PaginationMeta

Pagination metadata for list responses.

Per ADR-ASANA-008: Cursor-based pagination with opaque offset.

Attributes: limit: Number of items requested per page. has_more: Whether more items exist after this page. next_offset: Opaque cursor for next page (None if no more pages).

object
limit
required
Limit

Number of items per page

integer
>= 1
has_more
required
Has More

Whether more items exist

boolean
next_offset
Any of:
string

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string