File Alias

Generate shareable short URLs for files using aliases.

Create a shareable short URL for a file

Generate a short alias (URL-friendly ID) for any file to share publicly or with specific users.

# Create an alias for a file
curl -X POST "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/alias?apiKey=<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"value": "my-custom-alias"}'

If you omit value, a short ID is auto-generated.

Access files via alias

Access files directly using their alias — useful for embedding in websites or sharing.

# View file by alias
curl "/api/v1/:alias"

# Download file by alias
curl "/api/v1/:alias/download"

Note

Alias access requires the requesting user to be a member of the tenant that owns the file.