Docs
Add Folder Associations
POST /drives/{eventId}/folders/{folderId}/associations
POST
/drives/{eventId}/folders/{folderId}/associationsRequired 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. |
Shares a folder with users, collaborators, and/or areas. Folder-level associations grant access to the folder and are visible when viewing the folder's details. The request body structure is identical to Add File Associations.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| folderId | Guid | Required | The folder ID. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| users | array | Required | User associations. Can be empty (`[]`). |
| collaborators | array | Required | Collaborator associations. Can be empty (`[]`). |
| areas | array | Required | Area associations. Can be empty (`[]`). |
Each association: { "id": Guid, "permissions": ["File.Read"], "isReviewer": false }
See Add File Associations for the full Association Object, File Permissions, and error details.
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |
NOT_FOUND | 404 | Folder, collaborator, or area not found. |
BAD_REQUEST | 400 | Duplicate association. |