GET/drives/{eventId}/partitions/{partitionId}/shared
Required 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. |
Returns all files and folders shared with a specific partition (collaborator or area), along with the permissions granted. Supports optional path and association filtering for navigating into a specific shared subtree.
Path Parameters
| Field | Type | Required | Description |
|---|
| driveId | Guid | Required | The event ID. |
| partitionId | Guid | Required | The partition ID (collaborator ID or area ID). |
Query Parameters
| Field | Type | Required | Description |
|---|
| path | string | Optional | Navigate into a specific path within the shared subtree (e.g., `/{folderId}`). Omit to return top-level shared items. |
| association | Guid | Optional | The association ID that granted access to the path. Required when `path` is provided. |
Response Fields
| Field | Type | Description |
|---|
| pathParts | array | Breadcrumb trail for the current path. Each part has `name`, `path`, and `grantedAssociation`. |
| files | array | Files at the current path. See **Item Fields**. |
| folders | array | Folders at the current path. See **Item Fields**. |
| permissions | array | Permissions on the current path. |
Item Fields
| Field | Type | Description |
|---|
| id | Guid | The item's unique ID. |
| grantedAssociation | Guid | The association ID that granted access to this item. |
| type | string | `"File"`, `"Deliverable"`, or `"Folder"`. |
| name | string | Display name. |
| description | string | Optional description. |
| path | string | Parent path of the item. |
| fullPath | string | Full path including the item's own ID. |
| permissions | array | Permissions the partition has on this item. |
| associations | object | Collaborator, area, and user associations on the item. |
| versions | array | Version tags for files. Empty for folders. |
Error Codes
| Code | HTTP Status | Description |
|---|
UNAUTHORIZED | 401 | Missing or invalid token, or no access to this partition. |
NOT_FOUND | 404 | Drive or partition not found. |
BAD_REQUEST | 400 | path provided without a matching association ID. |