Abort an upload
Cancels a resumable upload and releases its storage.
Permission
The key must be granted files.write
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Discards the parts already stored. Worth calling on a failure rather than leaving a session open, because the parts occupy the workspace's storage until it is.
Path parameters
| Field | Type | Description |
|---|---|---|
session required |
string | The session to abandon. |
Request
curl https://api.veruapis.com/v1/files/uploads/:session \
-X DELETE \
-H "Authorization: Bearer vak_live_..." \
-H "Idempotency-Key: $(uuidgen)"Idempotency-Key is required on every write. Retrying with the same key returns the original response rather than repeating the operation, so a timeout is something you retry rather than something you investigate.
Response
Answers 204.
{
"data": 204 No Content,
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}Worth calling when you give up: the parts already stored count against the workspace until the session is abandoned.
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Complete an upload
- POST Create a folder
- POST Start an upload
- DELETE Delete a file
- DELETE Delete a folder
- GET Download a file
- GET Get file metadata
- GET Get upload status
- GET List files
- GET List folders
- GET List file permissions
- POST Share a file
- DELETE Revoke file access
- PATCH Rename or move a file
- PATCH Rename or move a folder
- PUT Upload a part