Get an upload

Get an upload with the Wavegrain Posting API: GET /api/v1/media/{id}. Parameters, responses and an example request.

GET /api/v1/media/{id} is part of the Posting API. Every call needs an access key: see Authentication.

Needs the read permission. An image: whether it arrived. A video: its state, what the check read from the file, which networks take it and why not, and while it uploads, fresh addresses for the parts still missing.

Parameters

NameInTypeRequiredNotes
idpathstringyes

Example request

curl https://wavegrain.com/api/v1/media/ID \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"

Responses

StatusMeaning
200The upload.
401No access key, or an unknown, revoked or expired one
403The key lacks the permission, or the account has no active plan
404No such upload, or not yours.
429Too many requests for the key or the account
500Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing.

A successful answer:

{
  "id": "upl_a8Zk2Qw",
  "kind": "image",
  "status": "ready",
  "width": 1080,
  "height": 1350
}

More in the Posting API

Something wrong or missing? Write to support@wavegrain.com.