Granting access

To enable other users to track the statuses of routes and orders, add them to the interface and configure their permissions.

Adding a company manager

Access is provided with Yandex ID.

In Routing workspace

1. Open Routing Workspace.

2. In the menu on the left, go to Settings → Managers.

3. Add users:

   1. At the bottom of the page, specify the new user's email address.

   2. To add multiple users at once, specify their email addresses separated by comma.

   3. Click Add.

      

In the API

Note

When adding a user with the API, assign them the manager, dispatcher, or administrator role.

Send a request to the users resource. In the request, specify the user's username and role:

Request:

Windows

MacOS/Linux

cURL

curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-OAuth-token>" -X POST -d @<File_path_in_UTF-8_encoding> https://courier.yandex.ru/api/v1/companies/<your-company-id>/users

File

{"login":"alice.the.girl", "role":"manager"}

cURL

curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-OAuth-token>" -X POST -d '{"login":"alice.the.girl", "role":"manager"}' https://courier.yandex.ru/api/v1/companies/<your-company-id>/users

Result:

{
  "id": 197162,
  "login": "alice.the.girl",
  "role": "manager"
}

Configuring permissions

After adding an employee:

In Routing workspace

1. Open the user card.

   

2. Select a role: Manager, Dispatcher, or Administrator.

3. When you assign the Manager or Dispatcher role to a user, specify which depots and companies they should have access to. To do this, select the required options in the Depots section. The employee will get access to routes that start from the chosen depots.

   

In the API

A role is assigned to a user when you add them, and access to depots and companies for a Manager and Dispatcher is set in the interface.

Once the user is registered and added to the system, they will have access to Routing workspace interface at: https://yandex.com/courier/.

Deleting a user

In Routing workspace

1. Open Routing Workspace.

2. In the menu on the left, go to Settings → Managers.
3. Open the user card.
4. At the bottom of the page, click Delete user.

In the API

Send a request to the users resource. In the URI, specify the user ID:

Request:

cURL

curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-OAuth-token>" -X DELETE https://courier.yandex.ru/api/v1/companies/<your-company-id>/users/<your-company-id>

Result:

{
  "id": 197215,
  "login": "alice.the.girl",
  "role": "manager"
}