User

Your employees, contractors and other users.

Operations

GET/v1/users/specGET/v1/usersPOST/v1/usersGET/v1/users/{userId}PATCH/v1/users/{userId}

---

OpenAPI Spec

GET

/v1/users/spec

Get OpenAPI 3.1.0 spec for User API

Responses

Returns OpenAPI 3.1.0 spec for User API

Content-Type

application/json

{

}

GET

/v1/users/spec

Playground

Samples

cURL

JavaScript

PHP

Python

---

List Users

GET

/v1/users

List Users

Authorizations

apiKey

TypeHTTP (bearer)

Parameters

Query Parameters

page

Typenumber

Minimum0

Default0

size

Typenumber

Minimum1

Maximum20

Default10

id

roleId

fullName

email

shortName

roleType

staffNumber

deactivatedAt

externalId

createdAt

updatedAt

Responses

List response

Content-Type

application/json

{

"page": 0,

"pages": 0,

"size": 10,

"items": [

{

"id": 0,

"fullName": "string",

"email": "string",

"shortName": "string",

"staffNumber": "string",

"color": "#FFFFFF",

"roleId": 0,

"roleType": "string",

"deactivatedAt": "string",

"createdAt": "string",

"updatedAt": "string",

"externalId": "string"

}

]

}

GET

/v1/users

Playground

Server

Authorization

apiKey

Variables

Key

Value

page

size

id

roleId

fullName

email

shortName

roleType

staffNumber

deactivatedAt

externalId

createdAt

updatedAt

Samples

cURL

JavaScript

PHP

Python

---

Create a new User

POST

/v1/users

Create a new User

Authorizations

apiKey

TypeHTTP (bearer)

Request Body

application/json

{

"fullName": "string",

"email": "string",

"password": "string",

"roleId": 0,

"shortName": "string",

"staffNumber": "string",

"color": "#FFFFFF",

"deactivatedAt": "string",

"externalId": null

}

Responses

User found

Content-Type

application/json

{

"id": 0,

"fullName": "string",

"email": "string",

"shortName": "string",

"staffNumber": "string",

"color": "#FFFFFF",

"roleId": 0,

"roleType": "string",

"deactivatedAt": "string",

"createdAt": "string",

"updatedAt": "string",

"externalId": "string"

}

POST

/v1/users

Playground

Server

Authorization

apiKey

Body

Samples

cURL

JavaScript

PHP

Python

---

Get a User

GET

/v1/users/{userId}

Get a User by ID

Authorizations

apiKey

TypeHTTP (bearer)

Parameters

Path Parameters

userId*

Typeinteger

Required

Format"int32"

Responses

User found

Content-Type

application/json

{

"id": 0,

"fullName": "string",

"email": "string",

"shortName": "string",

"staffNumber": "string",

"color": "#FFFFFF",

"roleId": 0,

"roleType": "string",

"deactivatedAt": "string",

"createdAt": "string",

"updatedAt": "string",

"externalId": "string"

}

GET

/v1/users/{userId}

Playground

Server

Authorization

apiKey

Variables

Key

Value

userId*

Samples

cURL

JavaScript

PHP

Python

---

Update a User

PATCH

/v1/users/{userId}

Update a User by ID

Authorizations

apiKey

TypeHTTP (bearer)

Parameters

Path Parameters

userId*

Typeinteger

Required

Format"int32"

Request Body

application/json

{

"fullName": "string",

"email": "string",

"password": "string",

"roleId": 0,

"shortName": "string",

"staffNumber": "string",

"color": "string",

"deactivatedAt": "string",

"externalId": "string"

}

Responses

User found

Content-Type

application/json

{

"id": 0,

"fullName": "string",

"email": "string",

"shortName": "string",

"staffNumber": "string",

"color": "#FFFFFF",

"roleId": 0,

"roleType": "string",

"deactivatedAt": "string",

"createdAt": "string",

"updatedAt": "string",

"externalId": "string"

}

PATCH

/v1/users/{userId}

Playground

Server

Authorization

apiKey

Variables

Key

Value

userId*

Body

Samples

cURL

JavaScript

PHP

Python

---