GET/drives/{eventId}/users/{userId}/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 directly with a specific user, along with the permissions granted. A user can only retrieve their own shared items. 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. |
| userId | Guid | Required | The ID of the user whose shared items to retrieve. Must match the authenticated user. |
Query Parameters
| Field | Type | Required | Description |
|---|
| path | string | Optional | Navigate into a specific path within the user's 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` (the association ID that granted access to this path segment). |
| files | array | Files at the current path. See **Item Fields**. |
| folders | array | Folders at the current path. See **Item Fields**. |
| permissions | array | Permissions the user has at the current path (e.g., `"File.Read"`, `"File.Edit"`, `"File.*"`). |
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 (e.g., `/{folderId}/{fileId}`). |
| permissions | array | Permissions the user has on this item. |
| associations | object | Collaborator, area, and user associations on the item. |
| versions | array | Version tags for files (e.g., `["Version 1", "Version 2"]`). Empty for folders. |
Error Codes
| Code | HTTP Status | Description |
|---|
UNAUTHORIZED | 401 | Missing or invalid token, or requesting items for a different user. |
NOT_FOUND | 404 | Drive or user not found. |