Docs
Add File Format
POST /drives/{eventId}/files/{fileId}/versions/{versionId}/formats
POST
/drives/{eventId}/files/{fileId}/versions/{versionId}/formatsRequired 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. |
Uploads an additional format (file representation) to an existing version. A version can hold multiple formats — for example, the same document in PDF, Word, and image form.
Returns a SAS URI for uploading the binary. After receiving the response, upload the file to the sasUri using an HTTP PUT request.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
| fileId | Guid | Required | The file ID. |
| versionId | Guid | Required | The version ID. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| fileFormat | string | Required | MIME type of the format being uploaded (e.g., `"application/pdf"`, `"image/jpeg"`). |
| fileSize | int | Required | Size of the file in bytes. Must be greater than zero. |
Example Response
{
"sasUri": "https://storage.blob.core.windows.net/..."
}
Response Fields
| Field | Type | Description |
|---|---|---|
| sasUri | string | Time-limited write SAS URI. Upload the file binary to this URI via `PUT`. |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |
NOT_FOUND | 404 | File or version not found. |
BAD_REQUEST | 400 | Invalid file format or file size. |