Documentation

Check an upload

GET/v1/drops/uploads/{id}Drops

Where an upload stands: the parts stored so far, so a client that lost track can send only the rest.

Parameter	Type	Required	Description
`id`	string, in the path	required	The upload's id.

curl -s "https://snip.link/v1/drops/uploads/id" \
  -H "Authorization: Bearer $SNIP_KEY"

{
  "size": "1.2 GB",
  "status": "open"
}

Field	Type	Description
`id`	string
`name`	string
`type`	string
`bytes`	integer
`size`	string
`part_bytes`	integer	Every part's size but the last.
`parts`	integer	How many parts the file goes up in, numbered from 1.
`received`	integer[]	Part numbers stored so far.
`status`	open \| finishing \| done
`expires_at`	string	When an unfinished upload is cancelled.
`link_id`	string, null	The file's link, once finished.

Status	Meaning
401	The API key is missing, malformed or revoked.
404	No link by that id or ending in this account.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).