Skip to main content
GET
Get Upload
Status of an upload sent in pieces (see Large Files), then its result.

Behavior

  • While pieces are still arriving, 200 with upload.status: uploading. After the last piece, upload.status: processing until the file is stored.
  • When processing finishes, 200 with the same {url, post} body POST /upload returns for one file, or the {post} body of POST /posts/{code}/files when the pieces went there. A failed upload returns its error at the status that endpoint would have used.
  • The result is kept for 10 minutes after processing finishes. After that, and for an id that is unknown, expired or belongs to another account or team, the response is 404.
  • Send it to https://{region}.relay.snipp.gg from upload.region.
  • 20 requests per 30 seconds. Polling every 2 seconds stays under it.

Example

Authorizations

relay-key
string
header
required

Your relay key from snipp.gg/settings/relay

Path Parameters

id
string
required

The upload.id returned for the first piece.

Pattern: ^[a-f0-9]{32}$

Response

Success

Still uploading or processing.

upload
object
required