Drive > Files > Dropbox

Convert a folder into a dropbox

<note>A dropbox allows unauthenticated users to upload files onto the drive via a public link (see Drive > External Access > Dropbox).</note>

post/2/drive/{drive_id}/files/{file_id}/dropbox

Path parameters

drive_idinteger required

Drive identifier

file_idinteger required

File identifier

Request body

aliasstring nullable

Alias of the dropbox

email_when_finishedboolean

Send an email when done

limit_file_sizeinteger nullable

Maximum accepted file size (bytes)

passwordstring nullable

Password for protecting the dropbox

valid_untilinteger nullable

Maximum validity date

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

Example response

{
  "result": "success",
  "data": {
    "directory": {
      "name": "Directory V3",
      "path": "/full/path/Directory V3",
      "type": "file",
      "status": "locked",
      "drive_id": 1111,
      "depth": 3,
      "shared_root_id": 1,
      "sharelink": {
        "url": "https://kdrive.infomaniak.com/app/share/xxxx/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
        "right": "inherit"
      },
      "lock": {
        "description": "365",
        "token": "onlyoffice:123456"
      },
      "categories": [
        {
          "user_validation": "TO_VALIDATE",
          "category": {
            "color": "#FF1493"
          }
        }
      ],
      "color": "#0098ff",
      "external_import": {
        "application": "dropbox",
        "status": "canceled"
      },
      "rewind": {
        "status": "canceled",
        "mode": "directory",
        "archiving": "all"
      }
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.