Skip to main content
HEAD
/
v2
/
uploads
/
{uploadId}
Get Upload Status
curl --request HEAD \
  --url https://api.tusky.io/v2/uploads/{uploadId} \
  --header 'Tus-Resumable: <tus-resumable>'
{
  "Upload-Offset": {},
  "Upload-Length": {},
  "Tus-Resumable": {}
}
Check the current status of a resumable upload. Returns the byte offset the server has received so far. Use this to resume an interrupted upload from the correct position.

​
Path Parameters

​
uploadId
string
required
The upload session ID.

​
Headers

​
Tus-Resumable
string
required
tus protocol version. Must be 1.0.0.

​
Response

Returns 200 OK (or 204 No Content) with the current upload state in headers.
​
Upload-Offset
number (header)
Number of bytes the server has received. Resume uploading from this offset.
​
Upload-Length
number (header)
Total expected file size in bytes.
​
Tus-Resumable
string (header)
Protocol version. 1.0.0.

​
Example

curl -I https://api.tusky.io/v2/uploads/upload_xyz789 \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Tus-Resumable: 1.0.0"

​
Response Headers

HTTP/1.1 200 OK
Upload-Offset: 5242880
Upload-Length: 10485760
Tus-Resumable: 1.0.0
Always call this endpoint before resuming an interrupted upload. It tells you exactly where to continue from, preventing duplicate data transmission.