---
title: "Check media upload status"
method: GET
path: "/upload_media/status"
tags: ["Media Upload"]
---

# Check media upload status

`GET /upload_media/status`

## Request

- Base URL: `https://socialbu.com/api/v1`
- URL: `https://socialbu.com/api/v1/upload_media/status`
- Auth: HTTP bearer

Checks whether a media file has finished uploading to SocialBu's storage. Once `success` is `true`, use the returned `upload_token` in `existing_attachments` when creating a post.

## Query parameters

- `key` string

## Response `200`

File status

- object
  - `success` boolean: Indicates whether the file has been uploaded.
  - `message` string: A message confirming the media upload.
  - `upload_token` string, nullable: Pass this token value in existing_attachments when creating a post.

## Other responses

- `400`: Bad Request
- `422`: The given data was invalid.

---

[API](https://skmtc.dev/socialbu/apis/socialbu-api.md) · [All operations](https://skmtc.dev/socialbu/apis/socialbu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialbu/apis/socialbu-api/revisions/841b3ab0f671?raw)