Users
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
GET | |
PATCH | |
DELETE | |
GET | |
PATCH | |
POST | |
GET | |
POST | 
List all users
Required API key scopes
user:readQuery parameters
- emailstring
 - is_staffboolean
 - limitinteger
Number of results to return per page.
 - offsetinteger
The initial index from which to return the results.
 
Response
Example request
GET  /api /usersExample response
Status 200
List all users
Required API key scopes
user:readQuery parameters
- emailstring
 - is_staffboolean
 - limitinteger
Number of results to return per page.
 - offsetinteger
The initial index from which to return the results.
 
Response
Example request
GET  /api /usersExample response
Status 200
Retrieve users
Required API key scopes
user:readPath parameters
- uuidstring
 
Response
Example request
GET  /api /users /:uuidExample response
Status 200
Retrieve users
Required API key scopes
user:readPath parameters
- uuidstring
 
Response
Example request
GET  /api /users /:uuidExample response
Status 200
Update users
Required API key scopes
user:writePath parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Response
Example request
PATCH  /api /users /:uuidExample response
Status 200
Update users
Required API key scopes
user:writePath parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Response
Example request
PATCH  /api /users /:uuidExample response
Status 200
Delete users
Path parameters
- uuidstring
 
Example request
DELETE  /api /users /:uuidExample response
Status 204 No response body
Delete users
Path parameters
- uuidstring
 
Example request
DELETE  /api /users /:uuidExample response
Status 204 No response body
Retrieve users hedgehog config
Path parameters
- uuidstring
 
Example request
GET  /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
Retrieve users hedgehog config
Path parameters
- uuidstring
 
Example request
GET  /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
Update users hedgehog config
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
PATCH  /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
Update users hedgehog config
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
PATCH  /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
Create users scene personalisation
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
POST  /api /users /:uuid /scene_personalisationExample response
Status 200 No response body
Create users scene personalisation
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
POST  /api /users /:uuid /scene_personalisationExample response
Status 200 No response body
Retrieve users start 2fa setup
Path parameters
- uuidstring
 
Example request
GET  /api /users /:uuid /start_2fa_setupExample response
Status 200 No response body
Retrieve users start 2fa setup
Path parameters
- uuidstring
 
Example request
GET  /api /users /:uuid /start_2fa_setupExample response
Status 200 No response body
Create users two factor backup codes
Generate new backup codes, invalidating any existing ones
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
POST  /api /users /:uuid /two_factor_backup_codesExample response
Status 200 No response body
Create users two factor backup codes
Generate new backup codes, invalidating any existing ones
Path parameters
- uuidstring
 
Request parameters
- first_namestring
 - last_namestring
 - emailstring
 - notification_settingsobject
 - anonymize_databoolean
 - toolbar_mode
 - is_staffboolean
Designates whether the user can log into this admin site.
 - set_current_organizationstring
 - set_current_teamstring
 - passwordstring
 - current_passwordstring
 - events_column_config
 - has_seen_product_intro_for
 - theme_mode
 - hedgehog_config
 - role_at_organization
 
Example request
POST  /api /users /:uuid /two_factor_backup_codes