Client User (/user/client/)

You can test API methods on the interactive API browser page and without writing code
Some of the resources described on the page may not be available by default due to the type of application (see Creating and authorizing applications).

This resource is intended for creating, deleting, and managing and refining client-level user parameters. The client-level user has access to the settings and resources of a specific client, and depending on the type of access (access type) has full access (full) or read-only access (read_only) without the right to make any changes in the settings.

Description of data structures

Name

Type

Mandatory

Description

Name

Type

Mandatory

Description

client_id

integer

yes

ID of the client for which the user is being created

access

string

none

The type of access to resources. Can be 'full' or 'read_only' (no rights for changes)

comment

string

none

Comment (note)

email

string

yes

user's e-mail address

email_notify 

boolean

none

If the parameter takes the value 'True’, then the data for access to the system for the new user will be sent to the email address:

·     if the email_for_notify parameter is set – send it to the email from email_for_notify;

·     if the email_for_notify parameter is not set – to the current user (who creates)

email_for_notify

string

none

The field required for the email_notify parameter is the e-mail address where the data will be sent when creating a new user

extra_params

string

none

Field for additional parameters, can be adapted for any purpose

login

string

yes

User Login

name

string

yes

User Name

password

string

yes

User Password

status

string

none

User status. Can be: 'active' or 'blocked'

timezone

string

none

User's time zone

Resources of the "Client" section

POST /client/{client_id}/user/client/

Add a new user of the "Client" level"

URL Parameters

Name

Type

Name

Type

client_id

string

Request parameters

Name

Type

Name

Type

access

string

comment

string

email

string

email_notify 

boolean

extra_params

string

login

string

name

string

password

string

status

string

timezone

string

Response parameters

Name

Type

Name

Type

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

GET /client/{client_id}/user/client/

Get a list of “Client" level users

URL Parameters

Name

Type

Name

Type

client_id

string

Request Parameters (filter)

Name

Type

Name

Type

login

array [string]

id

array [integer]

Response parameters

Name

Type

Name

Type

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

PUT /client/{client_id}/user/client/{user_id}

Update the “Client" level user

URL Parameters

Name

Type

Name

Type

user_id

integer

client_id

string

Request parameters

Name

Type

Name

Type

comment

string

status

string

name

string

access

string

extra_params

string

timezone

string

password

string

email

string

Response parameters

Name

Type

Name

Type

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

GET /client/{client_id}/user/client/{user_id}

Request user parameters of the “Client" level

URL Parameters

Name

Type

Name

Type

user_id

integer

client_id

string

Response parameters

Name

Type

Name

Type

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

DELETE /client/{client_id}/user/client/{user_id}

Delete the "Client" level user

URL Parameters

Name

Type

Name

Type

user_id

integer

client_id

string