Users

List Users

get

Returns a list of all users.

Args: user_filter_model: Model that takes care of filtering, sorting and pagination. hydrate: Flag deciding whether to hydrate the output model(s) by including metadata fields in the response. auth_context: Authentication context.

Returns: A list of all users.

Authorizations

Query parameters

hydratebooleanOptionalDefault: false

sort_bystringOptionalDefault: created

logical_operatorstring · enumOptional

Logical Ops to use to combine filters on list methods.

Default: andPossible values:

pageinteger · min: 1OptionalDefault: 1

sizeinteger · min: 1 · max: 10000OptionalDefault: 20

idany ofOptional

string · uuidOptional

or

stringOptional

or

nullOptional

createdany ofOptional

string · date-timeOptional

or

stringOptional

or

nullOptional

updatedany ofOptional

string · date-timeOptional

or

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

full_nameany ofOptional

stringOptional

or

nullOptional

emailany ofOptional

stringOptional

or

nullOptional

activeany ofOptional

booleanOptional

or

stringOptional

or

nullOptional

email_opted_inany ofOptional

booleanOptional

or

stringOptional

or

nullOptional

external_user_idany ofOptional

string · uuidOptional

or

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

401

Unauthorized

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/users HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "index": 1,
  "max_size": 1,
  "total_pages": 1,
  "total": 1,
  "items": [
    {
      "body": {
        "created": "2025-07-19T15:09:46.645Z",
        "updated": "2025-07-19T15:09:46.645Z",
        "active": false,
        "activation_token": "text",
        "full_name": "",
        "email_opted_in": true,
        "is_service_account": true,
        "is_admin": true,
        "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
      },
      "metadata": {
        "email": "",
        "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
        "user_metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": false,
      "name": "text"
    }
  ]
}

Get User

get

Returns a specific user.

Args: user_name_or_id: Name or ID of the user. hydrate: Flag deciding whether to hydrate the output model(s) by including metadata fields in the response. auth_context: Authentication context.

Returns: A specific user.

Authorizations

Path parameters

user_name_or_idany ofRequired

stringOptional

or

string · uuidOptional

Query parameters

hydratebooleanOptionalDefault: true

Responses

200

Successful Response

application/json

401

Unauthorized

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/users/{user_name_or_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "body": {
    "created": "2025-07-19T15:09:46.645Z",
    "updated": "2025-07-19T15:09:46.645Z",
    "active": false,
    "activation_token": "text",
    "full_name": "",
    "email_opted_in": true,
    "is_service_account": true,
    "is_admin": true,
    "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "metadata": {
    "email": "",
    "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
    "user_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "resources": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "permission_denied": false,
  "name": "text"
}