Skip to main content
POST

Overview

The last step of Upload Media. Call it after the PUT to uploadUrl succeeded; it takes no body. Hooked checks that storage really holds the file and reads its real size, counts it against your plan’s storage, reads a video’s length and starts its thumbnail. The media is then COMPLETED and its id works in any create endpoint.
  • The file is not there yet: 400 The file was not uploaded. The media stays PENDING; PUT the file and call again.
  • The file is over 100 MB, or its real size does not fit your storage: the file is deleted and the media becomes FAILED. Start a new upload.
  • Calling it again on a COMPLETED media answers 200 with the same media; nothing is counted twice.

Errors

The thumbnail of a video is made a few seconds later: read it with Get Media.

Authorizations

x-api-key
string
header
required

Path Parameters

mediaId
string
required

The mediaId from Upload Media.

Response

Upload completed

success
boolean
message
string
data
object

An image or video of your team's media library. Pass its id wherever a create endpoint takes a media id, once status is COMPLETED.