Docs
Add File Link
POST /drives/{eventId}/files/{fileId}/links
POST
/drives/{eventId}/files/{fileId}/linksRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Creates a public shareable link for a file. Public links allow unauthenticated access via the Public endpoints (GET /drives/{driveId}/links/{linkId}). Requires File.* (admin) permission on the file.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| fileId | Guid | Required | The file ID. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | A display name for the link. |
| permissions | array | Required | Permissions granted to anyone who accesses the link (e.g., `["File.Read"]`). |
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or caller does not have File.* on this file. |
NOT_FOUND | 404 | File not found. |