# The API

## Quick start for PHP developers

<div id="bkmrk-read-the%C2%A0authorizati">1. <div>Read the [Authorization](http://docs.filerun.com/api#authorization "api ↵") section bellow to understand the requirements.</div>
2. <div>Follow “[a new client application](http://docs.filerun.com/api#adding "api ↵")”</div>
3. <div>Download and use the Web File Share PHP API Client library: [https://github.com/WebFileShare/api-client](https://github.com/filerun/api-client "https://github.com/filerun/api-client")</div>

</div>## Authorization

The WebFileShare API uses the [OAuth 2.0 protocol](http://tools.ietf.org/html/rfc6749 "http://tools.ietf.org/html/rfc6749") for authentication and authorization.

If you are new to OAuth2, here you can find a good article about it here: [https://aaronparecki.com/articles/2012/07/29/1/oauth2-simplified](https://aaronparecki.com/articles/2012/07/29/1/oauth2-simplified "https://aaronparecki.com/articles/2012/07/29/1/oauth2-simplified")

Important note: To use the WebFileShare API, your webserver needs to be configured with a SSL certificate. The URL of the Web File Share installation needs to start with HTTPS. Unsecured HTTP connections will be refused, as it represents a serious security vulnerability. Get a free SSL certificate here: [https://letsencrypt.org](https://letsencrypt.org/ "https://letsencrypt.org")

### Testing without SSL

Adding the following line inside /customizables/config.php would allow OAuth2 to be enabled even though you do not access the Web File Share installation via HTTPS:

$config\['app'\]\['api'\]\['oauth2'\]\['allow\_over\_http'\] = true;

Warning: This disables the entire security of the API. Your Web File Share users private information will be at risk. Do not use it for production!

### Adding a new client application

Before you can start using OAuth2 with your application, you’ll need to tell Web File Share a bit of information about the application. Follow these steps:

<div id="bkmrk-login-to-web-file-sh">1. <div>Login to Web File Share as superuser</div>
2. <div>Open the control panel and navigate to “System configuration” &gt; “Oauth2” &gt; “Clients”</div>
3. <div>Click “Add” and fill in the form</div>
4. <div>Web File Share will generate a “client id” and a “client secret”. Make a note of these two, as you will need to set them in your application.</div>

</div>### Obtain an access token

Before your application can access private data using a Web File Share API, it must obtain an access token that grants access to that API. A single access token can grant varying degrees of access to multiple APIs. A variable parameter called “scope” controls the set of resources and operations that an access token permits. During the access-token request, your application sends one or more values in the “scope” parameter.

There are several ways to make this request, and they vary based on the type of application you are building. For example, a web-based application might request an access token using a browser redirect to Web File Share, while an application installed on a device that has no browser uses web service requests.

Some requests require an authentication step where the user logs in with their Web File Share account. After logging in, the user is asked whether they are willing to grant the permissions that your application is requesting. This process is called \*user consent\*.

If the user grants the permission, the Web File Share Authorization Server sends your application an access token (or an authorization code that your application can use to obtain an access token). If the user does not grant the permission, the server returns an error.

The authorization sequence begins when your application redirects a browser to a specific Web File Share URL; the URL includes query parameters that indicate the type of access being requested.

#### For web applications

This method is called in OAuth 2.0 terms “the authorization code flow”.

Authentication Endpoint URL: /oauth2/authorize/

The set of query string parameters supported by the Web File Share Authorization Server for web server applications are:

<div id="bkmrk-parameter-value-desc"><div><table style="border-collapse: collapse; border: none; height: 398px;" width="755"><tbody><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="78">Parameter

</td><td style="width: 1.0in; border: solid windowtext 1.0pt; border-left: none; padding: 0in 5.4pt 0in 5.4pt;" width="96">Value

</td><td style="width: 337.25pt; border: solid windowtext 1.0pt; border-left: none; padding: 0in 5.4pt 0in 5.4pt;" width="450">Description

</td></tr><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="78">response\_type

</td><td style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="96">code

</td><td style="width: 337.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="450">Determines whether the Web File Share OAuth 2.0 endpoint returns an authorization code. Web server applications should use code.

</td></tr><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="78">client\_id

</td><td style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="96">The “client id” you obtain from the Web File Share control panel

</td><td style="width: 337.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="450">Identifies the client that is making the request. The value passed in this parameter must exactly match the value shown in the Web File Share Control Panel

</td></tr><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="78">redirect\_uri

</td><td style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="96">One of the “redirect uri” values listed for this application

</td><td style="width: 337.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="450">Determines where the response is sent. The value of this parameter must exactly match one of the values listed for your application in the Web File Share control panel, including the http or https scheme, case, and trailing '/').

</td></tr><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="78">scope

</td><td style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="96">Space-delimited set of permissions that the application requests.

</td><td style="width: 337.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="450">Identifies the Web File Share API access type that your application is requesting.

</td></tr><tr><td style="width: 58.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="78">state

</td><td style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="96">Any string

</td><td style="width: 337.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="450">Provides any state that might be useful to your application upon receipt of the response. The Web File Share Authorization Server roundtrips this parameter, so your application receives the same value it sent. To mitigate against cross-site request forgery (CSRF), it is strongly recommended to include an anti-forgery token in the state, and confirm it in the response.

</td></tr></tbody></table>

</div></div>An example request URL is shown below, with line breaks for readability.

<div id="bkmrk-https%3A%2F%2Fwww.your-sit"><div><div>```
https://www.your-site.com/WebFileShare/oauth2/authorize/?
  scope=email%20profile&
  state=SOME-RANDOM-DATA&
  redirect_uri=https%3A%2F%2Fwww.your-app.com%2Fdo-something-with-the-code&
  response_type=code&
  client_id=f9c6f82cb3e872a20e6a310f33a9c450
```

</div></div></div>You web application will be redirecting the users to a similar URL. Web File Share then handles the user authentication and consent. The result is an authorization code, which your application can exchange for an “access token” and a “refresh token”.

##### Handling the response

The response will be sent to the “redirect\_uri” as specified in the request URL. If the user approves the access request, then the response contains an authorization code and the state parameter (if included in the request). If the user does not approve the request, the response contains an error message.

Important: if your response endpoint renders an HTML page, any resources on that page will be able to see the authorization code in the URL. Scripts can read the URL directly, and all resources may be sent the URL in the Referer HTTP header. Carefully consider if you want to send authorization credentials to all resources on that page (especially third-party scripts such as social plugins and analytics). To avoid this issue, we recommend that the server first handle the request, then redirect to another URL that doesn't include the response parameters.

##### Getting the access token

After your web application receives the authorization code, it should exchange it for an access token and a refresh token, by making an HTTP POST request to the following URL:

Token Endpoint URL: /oauth2/token/

Parameters:

<div id="bkmrk-parameter-descriptio"><div><div><table style="border-collapse: collapse; border: none;"><tbody><tr style="height: 6.7pt;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="150">**Parameter**

</td><td style="width: 355.25pt; border: solid windowtext 1.0pt; border-left: none; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="474">**Description**

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">code

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The authorization code returned from the initial request.

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">client\_id

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The “client id” obtained from the Web File Share control panel

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">client\_secret

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The client secret obtained from the Web File Share control panel.

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">redirect\_uri

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">One of the redirect URIs listed for this project in the

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">grant\_type

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">As defined in the OAuth 2.0 specification, this field must contain a value of “authorization\_code”.

</td></tr></tbody></table>

</div></div></div>A successful response to a request contains the following fields:

<div id="bkmrk-parameter-descriptio-0"><div><div><table style="border-collapse: collapse; border: none; height: 201px;" width="633"><tbody><tr style="height: 6.7pt;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="150">**Parameter**

</td><td style="width: 355.25pt; border: solid windowtext 1.0pt; border-left: none; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="474">**Description**

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">access\_token

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The token that needs to be sent to the Web File Share API for a regular request.

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">refresh\_token

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">A token that may be used to obtain a new access token. Refresh tokens expire in 30 days.</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">expires\_in

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The remaining lifetime of the access token. Access tokens expire in 60 minutes.

</td></tr><tr><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">token\_type

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">Identifies the type of token returned. At this time, this field will always have the value Bearer.

</td></tr></tbody></table>

</div></div></div><div id="bkmrk-here%27s-how-an-exampl"><div><div><div>Here's how an example response looks like:</div>```
{
"access_token":"PJIeg5uIs31JBmTGmcUFap6Gv2xhJQs84IqetJeL",
"token_type":"Bearer",
"expires_in":3600,
"refresh_token":"Sj5267kclpjhrvT0pdcE8mVbYxoZTu3u8flqg5cY"
}
```

</div></div></div>The application should store the refresh token for future use and use the access token to access the Web File Share API. Once the access token expires, the application uses the refresh token to obtain a new one.

#### For installed applications

This method is called in OAuth 2.0 terms the “resource owner credentials flow”. It is also known as the “password” flow.

Desktop and mobile application, if they cannot redirect the user to the Web File Share URL for authentication and providing consent, they usually just prompt the users for their Web File Share username and password.

The process requires just a direct HTTP POST call to the token endpoint (/oauth2/token/), with the following parameters:

<div id="bkmrk-parameter-descriptio-1"><div><div><table style="border-collapse: collapse; border: none; height: 201px;" width="633"><tbody style="box-sizing: border-box;"><tr style="height: 6.7pt;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="150">**Parameter**

</td><td style="width: 355.25pt; border: solid windowtext 1.0pt; border-left: none; padding: 0in 5.4pt 0in 5.4pt; height: 6.7pt;" width="474">**Description**

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">username

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The Web File Share user account username.

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">password

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The Web File Share user account password.</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">scope

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">Space-delimited set of permissions that the application requests. Identifies the Web File Share API access type that your application is requesting. Each API method that your application will be using requires a certain scope. See that further down in the documentation.

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">client\_id

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The “client id” obtained from the Web File Share control panel

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">client\_secret

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">The client secret obtained from the Web File Share control panel.

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">redirect\_uri

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">One of the redirect URIs listed for this application inside the Web File Share control panel.

</td></tr><tr style="box-sizing: border-box;"><td style="width: 112.25pt; border: solid windowtext 1.0pt; border-top: none; padding: 0in 5.4pt 0in 5.4pt;" width="150">grant\_type

</td><td style="width: 355.25pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0in 5.4pt 0in 5.4pt;" width="474">As defined in the OAuth 2.0 specification, this field must contain a value of “password”.

</td></tr></tbody></table>

</div></div></div><div id="bkmrk-please-see-the-above"><div><div><article class="col-sm-9 col-md-10 " id="bkmrk-please-see-the-above-0" style="box-sizing: border-box; display: block; position: relative; min-height: 1px; padding-left: 15px; padding-right: 15px; float: left; width: 1266px;">Please see the above section [Getting the access token](http://docs.filerun.com/api#getting_the_access_token "api ↵") for handling the response.

Note: This type of authorization is protected against brute force attacks, just as the regular Web File Share login. If you type in the wrong password too many times, the Web File Share user account will get deactivated.

**Example**

<div><div><div><div><div><div>```
curl -X POST -d "username=john&password=love123&scope=upload&client_id=WebFileShare0000000000000000000Mobile&client_secret=0000000000000000NoSecret0000000000000000&redirect_uri=http://localhost&grant_type=password" https://demo.WebFileShare.co/oauth2/token/
```

- <div>`john` and `love123` - are the Web File Share account's username and password</div>
- <div>`WebFileShare0000000000000000000Mobile` - is the the default API client id used by the mobile apps. It is recommended that you add a separate one, specific to your application.</div>
- <div>`0000000000000000NoSecret0000000000000000` - the API client secret</div>
- <div>`<a class="urlextern" href="http://localhost/" rel="nofollow noopener" style="box-sizing: border-box; background-color: transparent; color: #2196f3; text-decoration: none; transition: all 0.2s; background-repeat: no-repeat; background-position: 0px center; padding: 0px 0px 0px 18px; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAABdklEQVR4AWMgAVRo1zY3rGk41rC+rqvCBCJWBpPM4WoomLHtdtuv/t9Lfk263TtrQ0t7Oj9cbzZDc/W6s/8T7khD+P+F/8bv29PZlswJVVBu0vPuVZyNYHFZbmAqE1SR0cbjXR6pjGBO58am962Ta3e3ftqy6B5LCcMasOj7gInrm9jBzI4vTX+bfjT/7/4/p/w/zFXybUmt71u4wJzGfxP/t/xvA+KaP2XnQSKVFpWPav/U/6+HKJjz++OVJUDp1n9N/+r+19QyMCz1mPC/8X/X/26Igrn3GiUeL5n/v+F/8//6/9NOMTC0hDUDefP/L4MoOL6ickVeSQ1QqAGooPdBJE/lnloge/fhixBHftFd9bLkR83/+n/1QAXVP8qX1Pyv/L/s/12f/4xQNz8s3Pa/6X/Vvzqgour/5f/r/q//f2fmLy54WP7lfJN74eMSoKIyoNFz/5/+9ar+Px9aZL3Xfjvz7aO3/96+eLvsnSVE7CPhOAYA9nvIX0UoNU8AAAAASUVORK5CYII=');" target="_blank" title="http://localhost">http://localhost</a>` - one of the API configured redirect URLs for the particular API client</div>
- <div>`<a class="urlextern" href="https://demo.filerun.co/" rel="nofollow noopener" style="box-sizing: border-box; background-color: transparent; color: #2196f3; text-decoration: none; transition: all 0.2s; background-repeat: no-repeat; background-position: 0px center; padding: 0px 0px 0px 18px; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAABdklEQVR4AWMgAVRo1zY3rGk41rC+rqvCBCJWBpPM4WoomLHtdtuv/t9Lfk263TtrQ0t7Oj9cbzZDc/W6s/8T7khD+P+F/8bv29PZlswJVVBu0vPuVZyNYHFZbmAqE1SR0cbjXR6pjGBO58am962Ta3e3ftqy6B5LCcMasOj7gInrm9jBzI4vTX+bfjT/7/4/p/w/zFXybUmt71u4wJzGfxP/t/xvA+KaP2XnQSKVFpWPav/U/6+HKJjz++OVJUDp1n9N/+r+19QyMCz1mPC/8X/X/26Igrn3GiUeL5n/v+F/8//6/9NOMTC0hDUDefP/L4MoOL6ickVeSQ1QqAGooPdBJE/lnloge/fhixBHftFd9bLkR83/+n/1QAXVP8qX1Pyv/L/s/12f/4xQNz8s3Pa/6X/Vvzqgour/5f/r/q//f2fmLy54WP7lfJN74eMSoKIyoNFz/5/+9ar+Px9aZL3Xfjvz7aO3/96+eLvsnSVE7CPhOAYA9nvIX0UoNU8AAAAASUVORK5CYII=');" target="_blank" title="https://demo.filerun.co">https://demo.WebFileShare.co</a>` - the URL of your WebFileShare installation</div>

</div></div></div></div></div></div>### Refreshing the access token

As access tokens expire, you will need to get fresh one once in a while. You do that by making a HTTP call to the following URL:

Refresh Token Endpoint URL: `<strong style="box-sizing: border-box; font-weight: bold;">/oauth2/token/</strong>`

Parameters:

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">client\_id</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The “client id” obtained from the Web File Share control panel</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">client\_secret</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The client secret obtained from the Web File Share control panel.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">grant\_type</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">As defined in the OAuth 2.0 specification, this field must contain a value of “refresh\_token”.</td></tr><tr class="row4" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">refresh\_token</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The refresh token you have received along with the access token.</td></tr></tbody></table>

</div></div></div></div></div></div></div>A successful response to a request will be identical to the response you receive when you are requesting an initial access token (See [Getting the access token](http://docs.filerun.com/api#getting_the_access_token "api ↵")).

Note: Save refresh tokens in secure long-term storage and continue to use them as long as they remain valid.

## Calling the Web File Share API with the access token

After your application obtains an access token, you can use the token to make calls to the Web File Share API on behalf of a given user account. To do this, include the access token in a request to the API by including the “Authorization: Bearer” HTTP header.

Example:

<div><div><div><div><div><div>```
GET /WebFileShare/api.php/account/info HTTP/1.1
Authorization: Bearer 8vDeNtzJ8Nf1P0fH1YsvIubOMGttXpqOmupl3oD1
Host: www.your-site.com
```

</div></div></div></div></div></div>Where “`8vDeNtzJ8Nf1P0fH1YsvIubOMGttXpqOmupl3oD1`” is the access token received on the previous step.

For most API calls, the server reply will contain a JSON object in the response body. Successful requests will have a property named “success” with the boolean value “true”. For failed requests, the “success” value will be set to “false” and the “error” property will be populated with an textual description of the problem. For tasks which are supposed to provide information, such as attaching a web link to a file, the property “data” will be populated if the operation was successful.

Access tokens are valid only for the set of operations and resources described in the scope of the token request. For example, if an access token is issued for the purpose of listing directory contents (scope=list), it cannot be used for accessing the user's profile information (scope=profile). You can, however, send that access token to the WebFileShare API multiple times for similar operations.

Access tokens have limited lifetimes (around 1 hour). If your application needs access to the Web File Share API beyond the lifetime of a single access token, it can use the obtained refresh token to get a new access token.

## API methods

### Getting user account information

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/account/info</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">profile</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Retrieving lists of files and folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/browse/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">list</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Default value</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col4" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Examples:  
/ROOT - shows a list with items like “My Files”, “Shared with me”, “Starred” (the list can change in the future)  
/ - same as above  
/ROOT/HOME - items located inside the users home folder (My Files)  
/STARRED - starred items  
/PHOTOS - latest photos  
/MUSIC - latest audio files  
/SHARES - items shared by the user  
/LINKS - items shared through web links  
/ROOT/SHARED - users with shares or folders shared anonymously by other users  
/ROOT/123 - lists folders shared by user with ID 123.  
/ROOT/123/456 - list items inside the share with ID 456 owned by user with ID 123.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">itemType</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Choose type of items to list. Possible values:  
any - lists both files and folders  
files - lists only files  
folders - lists only folders</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">recursive</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">false</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">List items from all the subfolders.</td></tr><tr class="row4" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Allows you to choose what information should be retrieved for each file.</td></tr><tr class="row5" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[uuid\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">unique id which can be used for referencing the file or folder</td></tr><tr class="row6" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[mdate\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">modified date</td></tr><tr class="row7" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[mdateHuman\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">modified date in a friendly format</td></tr><tr class="row8" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[cdate\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">creation date</td></tr><tr class="row9" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[hasWebLink\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">if file has weblink attached to it or not</td></tr><tr class="row10" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[weblink\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">retrieve weblink URL</td></tr><tr class="row11" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[weblink-full\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">retrieve full weblink details</td></tr><tr class="row12" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[description\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">file type description</td></tr><tr class="row13" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[ext\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">file extension</td></tr><tr class="row14" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[type\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">type of file (defined inside system/data/filetypes.php)</td></tr><tr class="row15" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[icon\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">filename of the Web File Share icon associated with this type of files</td></tr><tr class="row16" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[hasThumb\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">shows if Web File Share can generate a thumbnail for the file</td></tr><tr class="row17" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[fileSize\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">includes the file size in bytes</td></tr><tr class="row18" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[nicerFileSize\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">includes formatted file size</td></tr><tr class="row19" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[commentsCount\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">includes number of attached user comments</td></tr><tr class="row20" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[label\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">includes files labels</td></tr><tr class="row21" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[isLocked\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">shows if file is locked</td></tr><tr class="row22" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[version\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">includes current file version</td></tr><tr class="row23" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details\[isShared\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array key</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">shows if folder is currently shared</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Example**

Listing only files from the users home folder, retrieving information about their attached weblinks and also including a formatted filesize:

<div><div><div><div><div><div>```
 path=/ROOT/HOME
 itemType=files
 details[[]]=nicerFileSize
 details[[]]=weblink
```

</div></div></div></div></div></div>**path=/ROOT/HOME** - the users home folder

**itemType=files** - listing only files

**details\[\]=nicerFileSize** - including a formatted filesize

**details\[\]=weblink** - including the URL, if a weblink is attached

Expected output:

<div><div><div><div><div><div>```
<span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"success"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">true</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"error"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"data"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
      <span class="st0" style="box-sizing: border-box; color: #ff0000;">"meta"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
         <span class="st0" style="box-sizing: border-box; color: #ff0000;">"path"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>ROOT<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>HOME"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="st0" style="box-sizing: border-box; color: #ff0000;">"parentPath"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>ROOT"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="st0" style="box-sizing: border-box; color: #ff0000;">"folderName"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"Home Folder"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="st0" style="box-sizing: border-box; color: #ff0000;">"perms"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"upload"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">true</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"download"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"1"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"alter"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">true</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
      <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
      <span class="st0" style="box-sizing: border-box; color: #ff0000;">"files"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="br0" style="box-sizing: border-box; color: #66cc66;">[</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"filename"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"WebFileShare_Admin_Guide.pdf"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"weblink"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"http:<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span><span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>demo.WebFileShare.com<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>wl<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>?id=89M"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"is_dir"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"nicerFileSize"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"123 KB"</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"filename"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"WebFileShare_License_Agreement.pdf"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"is_dir"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"nicerFileSize"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"116 KB"</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"filename"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"WebFileShare_User_Guide.pdf"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"is_dir"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"nicerFileSize"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"195 KB"</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"filename"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"Welcome.jpg"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"is_dir"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
            <span class="st0" style="box-sizing: border-box; color: #ff0000;">"nicerFileSize"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="st0" style="box-sizing: border-box; color: #ff0000;">"17 KB"</span>
         <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
      <span class="br0" style="box-sizing: border-box; color: #66cc66;">]</span>
   <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
<span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
```

- - - - - -

</div></div></div></div></div></div>### Retrieving metadata

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/metadata/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">metadata</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Default value</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col4" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Examples: /ROOT/HOME/file.ext - retrieves metadata for a file named `file.ext` available in the Web File Share user's home folder</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Searching files and folders by name

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/search/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">list</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Default value</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col4" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Path relative to the user's home folder.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">keyword</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The keyword to search the file names for.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">details</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The same as as for the task above.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Creating folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/createfolder/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">upload</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">POST/GET</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Web File Share path of the new folder's parent.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">name</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Name of the new folder.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Uploading files

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/upload/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">upload</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">PUT</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the target file.</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Example**

<div><div><div><div><div><div>```
curl -X PUT --header "Authorization: Bearer neY6uAjKO1KqQh98RZZ5DOgYjIPMuu9duvvHGUiN" -T your-file.ext https://demo.WebFileShare.co/api.php/files/upload/?path=/ROOT/HOME/make-new-folder/my-file.ext
```

- <div>`neY6uAjKO1KqQh98RZZ5DOgYjIPMuu9duvvHGUiN` - is the previously received “access_token”</div>
- <div>`your-file.ext` - is the path of the file you want to upload from the local computer</div>
- <div>`<a class="urlextern" href="https://demo.filerun.co/" rel="nofollow noopener" style="box-sizing: border-box; background-color: transparent; color: #2196f3; text-decoration: none; transition: all 0.2s; background-repeat: no-repeat; background-position: 0px center; padding: 0px 0px 0px 18px; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAABdklEQVR4AWMgAVRo1zY3rGk41rC+rqvCBCJWBpPM4WoomLHtdtuv/t9Lfk263TtrQ0t7Oj9cbzZDc/W6s/8T7khD+P+F/8bv29PZlswJVVBu0vPuVZyNYHFZbmAqE1SR0cbjXR6pjGBO58am962Ta3e3ftqy6B5LCcMasOj7gInrm9jBzI4vTX+bfjT/7/4/p/w/zFXybUmt71u4wJzGfxP/t/xvA+KaP2XnQSKVFpWPav/U/6+HKJjz++OVJUDp1n9N/+r+19QyMCz1mPC/8X/X/26Igrn3GiUeL5n/v+F/8//6/9NOMTC0hDUDefP/L4MoOL6ickVeSQ1QqAGooPdBJE/lnloge/fhixBHftFd9bLkR83/+n/1QAXVP8qX1Pyv/L/s/12f/4xQNz8s3Pa/6X/Vvzqgour/5f/r/q//f2fmLy54WP7lfJN74eMSoKIyoNFz/5/+9ar+Px9aZL3Xfjvz7aO3/96+eLvsnSVE7CPhOAYA9nvIX0UoNU8AAAAASUVORK5CYII=');" target="_blank" title="https://demo.filerun.co">https://demo.WebFileShare.co</a>` - is the URL of your Web File Share installation</div>
- <div>`/ROOT/HOME/make-new-folder/my-file.ext` - is the remote path where you wish the file to be uploaded. Web File Share will create the folder “make-new-folder” if it doesn't already exist.</div>

- - - - - -

</div></div></div></div></div></div>### Downloading files

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/download/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">download</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP DOWNLOAD</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the file.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Downloading thumbnails

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/thumbnail/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">download</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP DOWNLOAD</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the file.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Renaming files or folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/rename/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">modify</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP DOWNLOAD</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">newName</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The new file/folder name.</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Deleting files or folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/delete/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">delete</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the target file.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">permanent</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean (1/0)</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Either the file should be permanently removed, instead of just moved to the trash folder.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Starring files or folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL (add)</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/star/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL (remove)</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/unstar/</strong>`</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">modify</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row4" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the target file/folder.</td></tr></tbody></table>

</div>- - - - - -

</div></div></div></div></div></div>### Create web links on files and folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/weblink/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">weblink</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the target file/folder.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">singleDownload</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Returns a link which is valid for a single download. This does not affect web links the user might have previously created on the file/folder.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">temporary</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Returns a link which is valid for 15 minutes. This does not affect web links the user might have previously created on the file/folder.</td></tr></tbody></table>

</div></div></div></div></div></div></div>Example reply:

<div><div><div><div><div><div>```
<span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
  <span class="st0" style="box-sizing: border-box; color: #ff0000;">"success"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">true</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
  <span class="st0" style="box-sizing: border-box; color: #ff0000;">"error"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
  <span class="st0" style="box-sizing: border-box; color: #ff0000;">"data"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"status"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"created"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span> <span class="co1" style="box-sizing: border-box; color: #808080; font-style: italic;">//can also return "existing"</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"url"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"http:<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span><span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>www.yoursite.com<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>WebFileShare<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>wl<span class="es0" style="box-sizing: border-box; color: #000099; font-weight: bold;">\/</span>?id=CtmsT8IWoen3JDZIVbxvR3SH45gvvvxs"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"isdir"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span> <span class="co1" style="box-sizing: border-box; color: #808080; font-style: italic;">//or true if you are linking a folder</span>
  <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
<span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
```

- - - - - -

</div></div></div></div></div></div>### Sharing folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/share/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">share</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the folder.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">uid</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes if no “gid”</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">ID of Web File Share user to share folder with.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">gid</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes if no “uid”</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">ID of Web File Share group to share folder with.</td></tr><tr class="row4" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">anonymous</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if folder is to be shared anonymously.</td></tr><tr class="row5" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">upload</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if upload permission is granted.</td></tr><tr class="row6" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">download</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if download permission is granted.</td></tr><tr class="row7" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">comment</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if the permission to post comments is granted.</td></tr><tr class="row8" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">read\_comments</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if the permission to read comments is granted.</td></tr><tr class="row9" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">alter</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if the permission to make file changes is granted.</td></tr><tr class="row10" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">share</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify if the permission to share files is granted.</td></tr><tr class="row11" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">alias</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Specify an alias for the shared folder name.</td></tr></tbody></table>

</div></div></div></div></div></div></div>*Note: If the folder was already shared, the share settings will be updated. No errors will be returned in that case.*

<div><div><div><div><div><div>- - - - - -

</div></div></div></div></div></div>### Unsharing folders

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/files/unshare/</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">share</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">GET/POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">path</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The Web File Share path of the folder.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">uid</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes if no “gid”</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">ID of Web File Share user to be removed from the share.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">gid</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes if no “uid”</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">ID of Web File Share group to be removed from the share.</td></tr></tbody></table>

</div></div></div></div></div></div></div>*Note that the call will return an error if the folder is not shared with the specified user or group.*

<div><div><div><div><div><div>- - - - - -

</div></div></div></div></div></div>### Get Web File Share user account information

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/admin-users/info</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">admin</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">UID</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes, if `uname` not provided</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">User ID</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">uname</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes, if `UID` not provided</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Username</td></tr></tbody></table>

</div></div></div></div></div></div></div>### Add Web File Share user accounts

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/admin-users/add</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">admin</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Default value</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col4" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">generate\_password</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Set to 1 to have Web File Share assign a randomly generated password which matches the current password policy settings.</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">create\_home\_folder</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Set to 1 to have Web File Share create the user's home folder if it doesn't exist already.</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[username\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The username may not contain special characters, except for underscores, dashes, @, dots and spaces.</td></tr><tr class="row4" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[name\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row5" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[password\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row6" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[two\_step\_enabled\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row7" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[two\_step\_secret\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row8" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[last\_pass\_change\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">date</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">NULL</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row9" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[owner\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">NULL</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">This can be the ID of the parent independent admin user.</td></tr><tr class="row10" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[registration\_date\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">date</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">current date</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row11" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[activated\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">1</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row12" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[expiration\_date\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">date</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">NULL</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row13" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[require\_password\_change\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row14" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[email\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row15" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[receive\_notifications\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row16" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[company\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row17" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[website\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row18" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[description\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row19" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">data\[logo\_url\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row20" style="box-sizing: border-box;"><td class="col0" colspan="5" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row21" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[role\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">NULL</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row22" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_type\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">NULL</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Possible values: `simple`, `indep`</td></tr><tr class="row23" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_users\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row24" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_roles\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row25" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_notifications\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row26" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_logs\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row27" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_metaperms\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row28" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_over\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">mixed</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Set to “-ALL-” if the user is an admin who can manage all other users</td></tr><tr class="row29" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_max\_users\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row30" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[admin\_homefolder\_template\]</td><td class="col1" colspan="2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row31" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[homefolder\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The is an absolute path to a folder existing in the server's file system. Always use forward slash as a path separator, including on Windows servers.</td></tr><tr class="row32" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[space\_quota\_max\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row33" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[space\_quota\_current\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row34" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[traffic\_quota\_max\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row35" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[traffic\_quota\_current\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row36" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[readonly\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row37" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[upload\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">1</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row38" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[download\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">1</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row39" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[download\_folders\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">1</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row40" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[read\_comments\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row41" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[write\_comments\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row42" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[email\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row43" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[weblink\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row44" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[share\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row45" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[btsync\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row46" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[metaperms\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row47" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[file\_history\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">0</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row48" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[users\_may\_see\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">string</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">-ALL-</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row49" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">perms\[change\_pass\]</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">1</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row50" style="box-sizing: border-box;"><td class="col0" colspan="5" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td></tr><tr class="row51" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">groups</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;"> </td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col4" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">A list of group names. If groups with the specified names are not found, are automatically created.</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Example response**

Example response after successful request:

<div><div><div><div><div><div>```
<span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"success"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">true</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"error"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
   <span class="st0" style="box-sizing: border-box; color: #ff0000;">"data"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span><span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
      <span class="st0" style="box-sizing: border-box; color: #ff0000;">"generated_password"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"12345678"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
      <span class="st0" style="box-sizing: border-box; color: #ff0000;">"uid"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"44"</span>
   <span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
<span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
```

</div></div></div></div></div></div>Where “44” is the ID of the newly created user account and “12345678” is the password generated by Web File Share.

Example response after failed request:

<div><div><div><div><div><div>```
<span class="br0" style="box-sizing: border-box; color: #66cc66;">{</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"success"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="kw2" style="box-sizing: border-box; color: #000000; font-weight: bold;">false</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"error"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"The value of data[username] needs to be unique in the database"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">,</span>
    <span class="st0" style="box-sizing: border-box; color: #ff0000;">"code"</span><span class="sy0" style="box-sizing: border-box; color: #66cc66;">:</span> <span class="st0" style="box-sizing: border-box; color: #ff0000;">"username_in_use"</span>
<span class="br0" style="box-sizing: border-box; color: #66cc66;">}</span>
```

- - - - - -

</div></div></div></div></div></div>### Modify Web File Share user accounts

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/admin-users/edit</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">admin</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

Besides the parameters described higher, for adding user accounts, this API method uses also the following:

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">UID</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">integer</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">The user ID</td></tr></tbody></table>

</div></div></div></div></div></div></div>### Delete Web File Share user accounts

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><tbody style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Target URL</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">`<strong style="box-sizing: border-box; font-weight: bold;">/api.php/admin-users/delete</strong>`</td></tr><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Required scope</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">admin</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">HTTP Method</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">POST</td></tr><tr class="row3" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Output format</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">JSON</td></tr></tbody></table>

</div></div></div></div></div></div></div>**Request Parameters Reference**

<div><div><div><div><div><div><div><table class="inline table table-bordered table-condensed" style="box-sizing: border-box; border-collapse: collapse; border-spacing: 0px; background-color: transparent; width: 896px; max-width: 100%; margin-bottom: 23px; border: 1px solid #dddddd;"><thead style="box-sizing: border-box;"><tr class="row0" style="box-sizing: border-box;"><th class="col0" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Parameter</th><th class="col1" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Type</th><th class="col2" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Required</th><th class="col3" style="box-sizing: border-box; padding: 5px; text-align: left; vertical-align: bottom; line-height: 1.846; border-width: 0px 1px 1px; border-image: initial; border-color: initial #dddddd #dddddd #dddddd; border-style: initial solid solid solid;">Description</th></tr></thead><tbody style="box-sizing: border-box;"><tr class="row1" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">UIDS</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">array</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Yes</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">Array of user ID integers</td></tr><tr class="row2" style="box-sizing: border-box;"><td class="col0" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">deleteHomeFolder</td><td class="col1" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">boolean</td><td class="col2" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">No</td><td class="col3" style="box-sizing: border-box; padding: 5px; line-height: 1.846; vertical-align: top; border: 1px solid #dddddd;">If included, this will cause the user(s) home folders to also be deleted.</td></tr></tbody></table>

</div></div></div></div></div></div></div>## Revoking app authorization (for users)

Users can see the authorizations made for the various apps, inside the “Account Settings” and can revoke them from the same location at any time.

## Troubleshooting 

### "Check the "access\_token" parameter"

If you cannot get past the error “*The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed. Check the “access\_token” parameter.*”, although you have checked and your HTTP request includes the “Authorization” header with a valid “Bearer” token, perhaps PHP doesn't get the variable “`$_SERVER['HTTP_AUTHORIZATION']`” populated. In which case, if you are running Apache, make sure you have the following code inside the “`.htaccess`” file:

<div><div><div><div><div><div>```
RewriteEngine On
RewriteCond %{HTTP:Authorization} .+
RewriteRule .* - [[E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]]
```

</div></div></div></div></div></div>If you are using a virtual host, make sure the above is inside the Virtualhost tag, not in Directory tag.

<div><div><div><div><div></div></div><div><nav class="small" id="bkmrk-%C2%A0table-of-contents%C2%A0-" style="box-sizing: border-box; display: block; font-size: 11.96px; border-left: 1px solid #eeeeee; background-color: #ffffff;">######  <span style="box-sizing: border-box;">Table of Contents</span> 

<div>- [The API](http://docs.filerun.com/api#the_api)
    - [Quick start for PHP developers](http://docs.filerun.com/api#quick_start_for_php_developers)
    - [Authorization](http://docs.filerun.com/api#authorization)
        - [Testing without SSL](http://docs.filerun.com/api#testing_without_ssl)
        - [Adding a new client application](http://docs.filerun.com/api#adding_a_new_client_application)
        - [Obtain an access token](http://docs.filerun.com/api#obtain_an_access_token)
        - [Refreshing the access token](http://docs.filerun.com/api#refreshing_the_access_token)
    - [Calling the FileRun API with the access token](http://docs.filerun.com/api#calling_the_filerun_api_with_the_access_token)
    - [API methods](http://docs.filerun.com/api#api_methods)
        - [Getting user account information](http://docs.filerun.com/api#getting_user_account_information)
        - [Retrieving lists of files and folders](http://docs.filerun.com/api#retrieving_lists_of_files_and_folders)
        - [Retrieving metadata](http://docs.filerun.com/api#retrieving_metadata)
        - [Searching files and folders by name](http://docs.filerun.com/api#searching_files_and_folders_by_name)
        - [Creating folders](http://docs.filerun.com/api#creating_folders)
        - [Uploading files](http://docs.filerun.com/api#uploading_files)
        - [Downloading files](http://docs.filerun.com/api#downloading_files)
        - [Downloading thumbnails](http://docs.filerun.com/api#downloading_thumbnails)
        - [Renaming files or folders](http://docs.filerun.com/api#renaming_files_or_folders)
        - [Deleting files or folders](http://docs.filerun.com/api#deleting_files_or_folders)
        - [Starring files or folders](http://docs.filerun.com/api#starring_files_or_folders)
        - [Create web links on files and folders](http://docs.filerun.com/api#create_web_links_on_files_and_folders)
        - [Sharing folders](http://docs.filerun.com/api#sharing_folders)
        - [Unsharing folders](http://docs.filerun.com/api#unsharing_folders)
        - [Get FileRun user account information](http://docs.filerun.com/api#get_filerun_user_account_information)
        - [Add FileRun user accounts](http://docs.filerun.com/api#add_filerun_user_accounts)
        - [Modify FileRun user accounts](http://docs.filerun.com/api#modify_filerun_user_accounts)
        - [Delete FileRun user accounts](http://docs.filerun.com/api#delete_filerun_user_accounts)
    - [Revoking app authorization (for users)](http://docs.filerun.com/api#revoking_app_authorization_for_users)
    - [Troubleshooting](http://docs.filerun.com/api#troubleshooting)
        - ["Check the "access\_token" parameter"](http://docs.filerun.com/api#check_the_access_token_parameter)

</div></nav></div></div></div></div></article><div><span class="loginLink hidden-print" style="box-sizing: border-box;">[ ](http://docs.filerun.com/api?do=login&sectok=eb4e30fc66dda17082111c691eb4f9a0 "Log In")</span></div></div></div></div>![](http://docs.filerun.com/lib/exe/indexer.php?id=api&1511366310)