Secure documents & video
with one API call

# Upload a file and get a secure link
# Works with PDF, DOCX, PPTX, XLSX, images, and video

curl -X POST https://api.cloakshare.dev/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F file=@proposal.pdf \
  -F expires_in="72h" \
  -F require_email=true \
  -F watermark=true

// npm install form-data node-fetch
import fs from 'fs';

const form = new FormData();
form.append('file', fs.createReadStream('proposal.pdf'));
form.append('expires_in', '72h');
form.append('require_email', 'true');
form.append('watermark', 'true');

const res = await fetch(
  'https://api.cloakshare.dev/v1/links', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: form,
});
const { data } = await res.json();

# pip install requests
import requests

res = requests.post(
    "https://api.cloakshare.dev/v1/links",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"file": open("proposal.pdf", "rb")},
    data={
        "expires_in": "72h",
        "require_email": "true",
        "watermark": "true",
    },
)
data = res.json()["data"]

file, _ := os.Open("proposal.pdf")
body := &bytes.Buffer{}
w := multipart.NewWriter(body)
part, _ := w.CreateFormFile("file", "proposal.pdf")
io.Copy(part, file)
w.WriteField("expires_in", "72h")
w.WriteField("require_email", "true")
w.WriteField("watermark", "true")
w.Close()

req, _ := http.NewRequest("POST",
    "https://api.cloakshare.dev/v1/links", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", w.FormDataContentType())
resp, _ := http.DefaultClient.Do(req)

# The secure_url is what you send
# to your recipient.
#
# They see a secure viewer:
# - Email gate
# - Watermarked pages (or video frames)
# - No download button
# - Canvas rendering / HLS streaming

https://view.cloakshare.dev/s/lnk_xK9mP2nQ

// Send the secure_url to your recipient.
// They see a secure viewer with:
//   - Email gate
//   - Watermarked pages (or video frames)
//   - No download button
//   - Canvas rendering / HLS streaming

console.log(data.secure_url);
// https://view.cloakshare.dev/s/lnk_xK9mP2nQ

# Send the secure_url to your recipient.
# They see a secure viewer with:
#   - Email gate
#   - Watermarked pages (or video frames)
#   - No download button
#   - Canvas rendering / HLS streaming

print(data["secure_url"])
# https://view.cloakshare.dev/s/lnk_xK9mP2nQ

// Send the secure_url to your recipient.
// They see a secure viewer with:
//   - Email gate
//   - Watermarked pages (or video frames)
//   - No download button
//   - Canvas rendering / HLS streaming

fmt.Println(result.Data.SecureURL)
// https://view.cloakshare.dev/s/lnk_xK9mP2nQ

# Check analytics on your link

curl https://api.cloakshare.dev/v1/links/lnk_xK9mP2nQ/analytics \
  -H "Authorization: Bearer YOUR_API_KEY"

// Check analytics on your link

const analytics = await fetch(
  'https://api.cloakshare.dev/v1/links/lnk_xK9mP2nQ/analytics',
  { headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const { data } = await analytics.json();

# Check analytics on your link

res = requests.get(
    "https://api.cloakshare.dev/v1/links/lnk_xK9mP2nQ/analytics",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]

req, _ := http.NewRequest("GET",
    "https://api.cloakshare.dev/v1/links/lnk_xK9mP2nQ/analytics",
    nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
resp, _ := http.DefaultClient.Do(req)

# Set up a webhook for view events

curl -X POST https://api.cloakshare.dev/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhook",
    "events": ["link.viewed"]
  }'

// Set up a webhook for view events

const webhook = await fetch(
  'https://api.cloakshare.dev/v1/webhooks', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://your-app.com/webhook',
    events: ['link.viewed'],
  }),
});

# Set up a webhook for view events

res = requests.post(
    "https://api.cloakshare.dev/v1/webhooks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://your-app.com/webhook",
        "events": ["link.viewed"],
    },
)

payload := []byte(`{
    "url": "https://your-app.com/webhook",
    "events": ["link.viewed"]
}`)

req, _ := http.NewRequest("POST",
    "https://api.cloakshare.dev/v1/webhooks",
    bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)