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
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
id | path | string | yes |
Example request
curl https://wavegrain.com/api/v1/media/ID \
-H "Authorization: Bearer $WAVEGRAIN_KEY"
Responses
| Status | Meaning |
|---|---|
| 200 | The upload. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 404 | No such upload, or not yours. |
| 429 | Too many requests for the key or the account |
| 500 | Something 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
- List brands, groups and connected accounts:
GET /api/v1/accounts - List posts:
GET /api/v1/posts - Create a post:
POST /api/v1/posts - Get a post:
GET /api/v1/posts/{id} - Cancel a post:
DELETE /api/v1/posts/{id} - Start an image or video upload:
POST /api/v1/media - Delete a video:
DELETE /api/v1/media/{id} - Finish and check a video upload:
POST /api/v1/media/{id}/complete - Write captions:
POST /api/v1/captions - All endpoints
Something wrong or missing? Write to support@wavegrain.com.