Docs
Submit Review
POST /drives/{eventId}/files/{fileId}/versions/{versionId}/reviews
POST
/drives/{eventId}/files/{fileId}/versions/{versionId}/reviewsRequired 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. |
Submits or updates a review on a specific file version. The caller must be a designated reviewer for the file (have isReviewer: true on their association). If the reviewer has already submitted a review on this version, the previous review is replaced.
Submitting a review automatically recalculates the file's status:
- If any reviewer responded with
"Changes Requested", the status becomesChangesRequested. - If all reviewers responded with
"Approved", the status becomesApproved. - Otherwise, the status is
AwaitingApproval.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| fileId | Guid | Required | The file ID. |
| versionId | Guid | Required | The version ID to review. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| response | string | Required | The review response. Must be one of the values below. |
Review Responses
| Value | Description |
|---|---|
Approved | The reviewer approves this version. |
Changes Requested | The reviewer is requesting changes before approval. |
No Response | Resets the reviewer's response (withdraws a previous approval/rejection). |
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or caller is not a reviewer for this file. |
NOT_FOUND | 404 | File or version not found. |
BAD_REQUEST | 400 | Invalid response value. |