---
sidebar_position: 3
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Add users to file
 Defines access to the file for third-party users



`Function AddUsersToFile(Val Token, Val FileID, Val EmailAddresses, Val ViewOnly = True) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Token |
  | FileID | --fileid | String | ✔ | ID of the file to be accessed |
  | EmailAddresses | --emails | String, Array of String | ✔ | List of email addresses of users being added |
  | ViewOnly | --readonly | Boolean | ✖ | Prohibits file editing for the external user |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Dropbox

<br/>




```bsl title="1C:Enterprise/OneScript code example"
    Token = "sl.u.AFek3pOSv0J2wDs07zicUxqeTLOmDVgvG3WAteVgi6h_Mg0uxNJmCWyjF4dUMBAdvOI4FsoQF--dYAW9XDzMnKO0gBNIoY5Swqk2-BxVCrKhBwwJ6QZ3O6idfXSGd3rJGN7t4QQ74yCAramcQScDzS8qF2q_XnL7ZQgj23tDQSGeR5eVr5dCNYLYRwGW7PSiCIjBahF6ONAsAEu12gYOLCGXVUz_KHC2r2FcU9g5HXRG98f7Oj8CYvAefpveb_Y6dacVOm1lDUVNx3QAX25rjfekBKpaZl_SZKvbxOp6J6RyFS4T4mfL_rElrLE2omIbc26pet_jbcX2xih6QyVttNENtrxm-nP7SmsdvMO6Z1iq77HmeQWmtlgBsw7PPUMn-q-5iZzhUCnU7rL0ATbbPymifFhe1kkXtiNaqYoXgX0774MOtHplnGtnmDaTreMoyVCY1e6A9GXyx9-2_OXAK3Hq9LKgOo6Pi6GJw2d-0g1vlxYEQ9nm5C2QNgYwi7WRnO9xU9GQ8bgQzbhcKX89cpI2TCCmAwFIiY016msIFTCzmDwGk0ppwg5N7a7q4wE0CmXOzz8HfjLjgog8F4dU_3oDAQDbmY5w1z0dB56sfNBRpNQZWRIeoV0uWKCXKGvYGOW-of7ZFAlwBQ8ZStwjiAtNjf-KmYa4odcI8Bfx6JCUw7cBbHUTezOvvB-LDQ0p5uJUVrkv8a7Wxm37Fhjvt-R47nD_rO-...";
    Email = "h5bk6ft62s@privaterelay.appleid.com";
    File  = "kJU6-a-pT48AAAAAAAAABw";

    Result = OPI_Dropbox.AddUsersToFile(Token, File, Email, False);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint dropbox AddUsersToFile \
             --token "***" \
             --fileid "kJU6-a-pT48AAAAAAAAABw" \
             --emails "['h5bk6ft62s@privaterelay.appleid.com']" \
             --readonly true
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint dropbox AddUsersToFile ^
             --token "***" ^
             --fileid "kJU6-a-pT48AAAAAAAAABw" ^
             --emails "['h5bk6ft62s@privaterelay.appleid.com']" ^
             --readonly true
        ```
    </TabItem>
</Tabs>


```json title="Result"
[
 {
  "member": {
   ".tag": "email",
   "email": "h5bk6ft62s@privaterelay.appleid.com"
  },
  "result": {
   ".tag": "success",
   "success": {
    ".tag": "editor"
   }
  },
  "sckey_sha1": "ee2d8fd2cee052e103a52aa74be85bbebb8e6bb4",
  "invitation_signature": [
   "ee2d8fd2cee052e103a52aa74be85bbebb8e6bb4:ed7721b375882c806612d4056dad9f317cc98a22"
  ]
 }
]
```