---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/en/delivery/quickstart/manager.md
  - https://yandex.kz/routing/doc/kk/delivery/quickstart/manager.md
  - https://yandex.kz/routing/doc/ru/delivery/quickstart/manager.md
  - https://yandex.kz/routing/doc/tr/delivery/quickstart/manager.md
  - href: en/delivery/quickstart/manager.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: RouteQ — API implementation procedure — granting access
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/en/llms.txt


# 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 {#add-manager}

Access is provided with [Yandex ID](https://passport.yandex.com).

{% note info %}

Use your work or personal email to log in by creating a Yandex ID here: [https://passport.yandex.com/auth/preregister](https://passport.yandex.com/auth/preregister).

Username and email can contain Latin letters, digits, period, and hyphen.

{% endnote %}


**_In Routing Workspace_**

1. <!-- source: en/delivery/_includes/open-logist-workplace.md -->
   Open [Routing Workspace](https://yandex.com/courier/companies/).
   <!-- endsource: en/delivery/_includes/open-logist-workplace.md -->
2. In the menu on the left, go to **Settings** → **Managers**.
3. Add users:
   
   <!-- source: en/delivery/_includes/add-user.md -->
      
   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**.
       
       ![](../_images/manager-add.png)
   <!-- endsource: en/delivery/_includes/add-user.md -->

**Via the API**

: {% note info %}

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

  {% endnote %}


  Send a request to the [users](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/addsAUser) resource. In the request, specify the user's username and role:

  **Request:**

  {% list tabs %}

  - Windows

    cURL

    ```html
    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

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

  - MacOS/Linux

    cURL

    ```html
    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 
    ```

  {% endlist %}

  **Result**:
  
  ```json
  {
    "id": 197162,
    "login": "alice.the.girl",
    "role": "manager"
  }
  ```

## Configuring permissions {#access}

After adding an employee:

**_In Routing Workspace_**

<!-- source: en/delivery/_includes/access.md -->
1. Open the user card.
    
    ![](../_images/managers-1.png)
    
2. Select the **Manager**, **Dispatcher**, or **Administrator** role.
    
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.
    
    ![](../_images/access-to-depot.png)
<!-- endsource: en/delivery/_includes/access.md -->

**Via 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 a user has registered and has been added, they will have access to the Routing Workspace interface at [https://yandex.com/courier/](https://yandex.com/courier/).


## Deleting a user {#delete-user}

**_In Routing Workspace_**

1. <!-- source: en/delivery/_includes/open-logist-workplace.md -->
   Open [Routing Workspace](https://yandex.com/courier/companies/).
   <!-- endsource: en/delivery/_includes/open-logist-workplace.md -->
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**.

**Via the API**

: Send a request to the [users](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/deletesUser) resource. In the URI, specify the user ID:

  **Request:**

  cURL

  ```html
  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:**
  
  ```json
  {
    "id": 197215,
    "login": "alice.the.girl",
    "role": "manager"
  }
  ```

<!-- source: en/delivery/_includes/feedback.md -->
<a href="../feedback">
  <span class="button">Contact support</span>
</a>



[//]: # (Version without HTML\: \[Contact support\]\(../../../feedback.md\))
<!-- endsource: en/delivery/_includes/feedback.md -->