Create Temporary Signed URL

Generate short-lived, secure access URLs for private files. These links bypass default private ACL blocks for the duration specified.

HTTP Endpoint

POST /api/v1/files/{file_uid}/signed-url
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Parameters (JSON Body)

Field Type Required Description
purpose string No view (opens inline) or download (default - forces attachment download).
expires_seconds integer No Link validity duration in seconds (default 86400 - 24 hours, max 604800 - 7 days).
max_uses integer No Optional. Restrict link access count limit (revoked immediately once limit is reached).

Success Response (HTTP 200 OK)

{
  "success": true,
  "signed_url": "https://elept.com/f/file_abc123?t=8a3f...",
  "gateway_url": "https://elept.com/f/file_abc123?t=8a3f...",
  "token": "8a3f...",
  "expires_at": "2026-10-24 11:00:00",
  "max_uses": null
}

Code Examples

Node.js Fetch Request:
const response = await fetch('https://elept.com/api/v1/files/file_abc123/signed-url', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    purpose: "view",
    expires_seconds: 3600
  })
});
const result = await response.json();
console.log(result.signed_url);
Next: Public Assets