Docs
Get File
GET /drives/{eventId}/files/{fileId}
GET
/drives/{eventId}/files/{fileId}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 full details for a specific file, including its associations, links, and version summaries. Requires at least File.Read permission on the file's path.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| fileId | Guid | Required | The file ID. |
Response Fields
| Field | Type | Description |
|---|---|---|
| id | Guid | The file's unique ID. |
| partitionKey | Guid | The partition this file belongs to (event ID, collaborator ID, or area ID). |
| type | string | `"File"` or `"Deliverable"`. |
| name | string | Display name. |
| description | string | Optional description. |
| path | string | Parent path of the file. |
| fullPath | string | Full path including the file's own ID. |
| status | string | Current file status. See **File Statuses** below. |
| dueDate | DateTime | Due date (deliverables only). |
| assignedTo | object \| null | null |
| permissions | array | The current user's permissions on this file. |
| associatedUsers | array | Users with direct access. Each has `id`, `entityId`, `name`, `isReviewer`, and `permissions`. |
| associatedCollaborators | array | Collaborators with access. Same structure. |
| associatedAreas | array | Areas with access. Same structure. |
| links | array | Public links on this file. Each has `id`, `name`, and `permissions`. |
| versions | array | Version summaries. Each has `id`, `tag`, `status`, `comments` (count), and `formats` (MIME type strings). |
File Statuses
| Value | Description |
|---|---|
NoStatus | No status set (non-deliverable, or no reviewers). |
Incomplete | Deliverable with no versions uploaded. |
AwaitingApproval | Pending reviewer responses. |
ChangesRequested | At least one reviewer requested changes. |
Approved | All reviewers approved the latest version. |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or insufficient permissions on this file's path. |
NOT_FOUND | 404 | File not found in this drive. |