Reset Password
Check your e-mail for further instructions.
Reset
Name
getfolderpublink
Auth
yes
Description
Creates and returns a public link to a folder.
The folder is identified by folderid or path.
Same optional parameters as getfilepublink.
maxdownloads in this case limits total number of downloads from this folder (even for the same file).
URL
https://api.pcloud.com/getfolderpublink
Required
Parameter | Description |
folderid | int folder id of the folder for public link |
path | string path to the folder for public link |
Optional
Parameter | Description |
expire | datetime Datetime when the link will stop working |
maxdownloads | int Maximum number of downloads from this folder (even for the same file). |
maxtraffic | int Maximum traffic that this link will consume (in bytes, started downloads will not be cut to fit in this limit) |
shortlink | int If set, a short link will also be generated |
linkpassword | string Sets password for the link. |
Output
On success returns
Field | Description |
linkid | int ID that can be used to delete/modify this public link |
code | string link's code that can be used to retrieve the public link contents (with showpublink/getpublinkdownload) |
Field | Description |
linkid | int ID that can be used to delete/modify this public link |
shortcode | string short code that can also be passed to showpublink/getpublinkdownload |
shortlink | string a full https link to pc.cd domain with shortcode appended |
Example
{ "result": 0, "linkid": Link ID, "link": "https:\/\/my.pcloud.com\/#page=publink&code=LinkCode", "code": "LinkCode" }
Code | Description |
1000 | Log in required. |
1002 | No full path or folderid provided. |
1013 | Date/time format not understood. |
2000 | Log in failed. |
2005 | Directory does not exist. |
2014 | Please verify your email address to preform this action. |
2015 | Can not share root folder. |
2026 | You can only share your own files or folders. Copy the file to a folder you own if you need to share it. |
4000 | Too many login tries from this IP address. |
5000 | Internal error. Try again later. |