Skip to main content
POST
/
file-entries
/
{entryId}
/
shareable-link
curl -X POST https://app.drime.cloud/api/v1/file-entries/123456/shareable-link \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "secret123",
    "expires_at": "2024-03-01T00:00:00.000000Z",
    "allow_download": true,
    "allow_edit": false
  }'
{
  "status": "success",
  "link": {
    "id": 789,
    "hash": "3h8N1nxZq7WtyRmXDIosFupSl9MCrD",
    "user_id": 15843,
    "entry_id": 123456,
    "password": "$2y$10$BI8kz6zFeB0CA...",
    "expires_at": "2024-03-01T00:00:00.000000Z",
    "allow_edit": false,
    "allow_download": true
  }
}

Overview

Creates a new shareable link for a file or folder. Anyone with the link can access the file based on the permissions you set.

Path Parameters

entryId
integer
required
ID or hash of the file entry

Request Body

password
string
Optional password protection
expires_at
string
Optional expiration date (ISO 8601 format)
allow_edit
boolean
default:"false"
Allow editing via the link
allow_download
boolean
default:"false"
Allow downloading via the link

Response

The created shareable link object
status
string
Request status (success)
curl -X POST https://app.drime.cloud/api/v1/file-entries/123456/shareable-link \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "secret123",
    "expires_at": "2024-03-01T00:00:00.000000Z",
    "allow_download": true,
    "allow_edit": false
  }'
{
  "status": "success",
  "link": {
    "id": 789,
    "hash": "3h8N1nxZq7WtyRmXDIosFupSl9MCrD",
    "user_id": 15843,
    "entry_id": 123456,
    "password": "$2y$10$BI8kz6zFeB0CA...",
    "expires_at": "2024-03-01T00:00:00.000000Z",
    "allow_edit": false,
    "allow_download": true
  }
}
The share URL format is: https://app.drime.cloud/drive/shares/{hash}