List workspace users

Fetch all users for a specific workspace

Request schema

Path parameters

workspace_id

integerrequired

ID of the workspace

Query parameters

page

number

Designates which page of results to return. Always starts at 1. If 0 is specified, it defaults to 1.

default:

per_page

number

Determines the number of results on each page. It can't exceed 100.

default:

maximum:

100

order

string

Organizes the results based on their creation time, either ascending or descending.

default:

desc

enum:

"asc""desc"

Header parameters

Authorization

stringrequired

HTTP: basicAuth

HTTP AuthorizationScheme: basic

Http + 1.1

GET

https://app.getcensus.com/api/v1/workspaces/{workspace_id}/users

GET /api/v1/workspaces/{workspace_id}/users?page=SOME_NUMBER_VALUE&per_page=SOME_NUMBER_VALUE&order=SOME_STRING_VALUE HTTP/1.1
Authorization: Bearer REPLACE_BEARER_TOKEN
Host: app.getcensus.com

Responses

200

Successfully retrieved the list of workspace users.

404

Resource not found.

`200`

status

stringrequired

The outcome of the request

enum:

"success"

pagination

objectrequired

An object to help you navigate the list of results.

total_records

number

Total records in the collection.

example:

per_page

number

Records on each page.

default:

example:

prev_page

number | null

The previous page number, or null for the first page.

example:

page

number

The current page number.

default:

example:

next_page

number | null

The next page number, or null if it's the last page.

example:

last_page

number

The number of the last page with records.

example:

data

arrayrequired

The list of results.

string

Unique identifier for the user.

example:

12345

string

User's email address.

example:

john.doe@example.com

role

string

User's role.

enum:

"admin""member"

created_at

string

Timestamp of user account creation.

example:

2023-08-20T10:00:00Z

`404`

status

integer

HTTP status code.

enum:

"404"

{
  "status": "success",
  "pagination": {
    "total_records": 14,
    "per_page": 25,
    "prev_page": 1,
    "page": 2,
    "next_page": 3,
    "last_page": 10
  },
  "data": [
    {
      "id": "12345",
      "email": "john.doe@example.com",
      "role": "admin",
      "created_at": "2023-08-20T10:00:00Z"
    }
  ]
}