Skip to main content
POST
/
upload
Upload file
curl --request POST \
  --url https://media.postflow.app/api/v1/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "id": "<string>",
  "organization_id": "<string>",
  "user_id": "<string>",
  "media_folder_id": "<string>",
  "is_media_library": true,
  "type": 1,
  "url": "<string>",
  "client_name": "<string>",
  "file_name": "<string>",
  "mime_type": "<string>",
  "extension": "<string>",
  "size": 123,
  "thumbnail": "<string>",
  "preview": "<string>",
  "width": 123,
  "height": 123,
  "aspect_ratio": 123,
  "duration": 123,
  "fps": 123,
  "video_thumbnail_frame": "<string>",
  "video_thumbnail_custom": "<string>",
  "video_thumbnail_time": 123,
  "page_count": 123,
  "page_previews": [
    "<string>"
  ],
  "conversions": [
    "<string>"
  ],
  "alt_text": "<string>",
  "pivot_alt_text": [
    "<string>"
  ],
  "note": "<string>",
  "origin": 1,
  "is_processing": true,
  "is_converted": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
This endpoint uses a different base URL:https://media.postflow.app/api/v1

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
file
file
required

The file to upload. Max 2048 MB.

Allowed extensions: heic, avif, webp, jpeg, png, jpg, gif, pdf, srt, mp4, mov, mpeg, webm, avi, mp3.

Response

MediaData

id
string
organization_id
string
user_id
string | null

The ID of the user who uploaded the media

media_folder_id
string | null
is_media_library
boolean

Determines whether the media is part of the media library

type
enum<integer>

1 Image
2 Video
3 Audio
4 Document
5 Subtitles

Available options:
1,
2,
3,
4,
5
url
string
client_name
string | null
file_name
string
mime_type
string
extension
string
size
integer
thumbnail
string | null
preview
string | null
width
integer | null
height
integer | null
aspect_ratio
number | null
duration
number | null
fps
number | null
video_thumbnail_frame
string | null
video_thumbnail_custom
string | null
video_thumbnail_time
number | null
page_count
integer | null

Number of pages in the PDF document

page_previews
string[]
conversions
string[] | null
alt_text
string | null
pivot_alt_text
string[] | null
note
string | null
origin
enum<integer> | null

1 Import
2 ClickUp
3 GoogleDrive
4 Dropbox
5 Tenor
6 PostComment
7 Api

Available options:
1,
2,
3,
4,
5,
6,
7
is_processing
boolean
is_converted
boolean

The media has been converted to ensure compatibility with social platforms

created_at
string<date-time> | null
updated_at
string<date-time> | null