Docs
Get Folder Tree
GET /drives/{eventId}/partitions/{partitionId}/tree
GET
/drives/{eventId}/partitions/{partitionId}/treeRequired 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 the complete folder hierarchy for a partition. Use this to build a navigation tree for the drive. Each folder includes the user's applicable permissions for that path.
The partitionId is a partition id returned by Get Partitions — it will be the event ID, a collaborator ID, or an area ID depending on partition type.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| partitionId | Guid | Required | The partition ID (event ID, collaborator ID, or area ID). |
Example Response
[
{
"id": "019700aa-0001-7000-0000-000000000001",
"name": "Documents",
"fullPath": "/019700aa-0001-7000-0000-000000000001",
"permissions": ["File.*"]
},
{
"id": "019700aa-0001-7000-0000-000000000002",
"name": "Contracts",
"fullPath": "/019700aa-0001-7000-0000-000000000001/019700aa-0001-7000-0000-000000000002",
"permissions": ["File.Read"]
}
]
Response Fields
| Field | Type | Description |
|---|---|---|
| id | Guid | The folder's unique ID. |
| name | string | The folder's display name. |
| fullPath | string | ID-based path to this folder (e.g., `/{folderId}` or `/{parentId}/{folderId}`). |
| permissions | array | The current user's permissions on this folder. See **File Permissions** below. |
File Permissions
| Value | Description |
|---|---|
File.* | Admin — full access including sharing and deletion. |
File.Read | Read-only access. |
File.Edit | Can upload new content and edit metadata. |
File.Delete | Can delete files and 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. |