POST /2/media/upload

Uploads an image or a subtitle using a single API call.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
media_category String Yes

A string enum value which identifies a media use-case. This identifier is used to enforce use-case specific constraints (e.g. file size) and enable advanced features.

Possible values:

  • "subtitles"
  • "tweet_image"
  • "dm_image"
media Yes
media_type String No

The type of image or subtitle.

Possible values:

  • "image/jpeg"
  • "image/pjpeg"
  • "image/png"
  • "image/bmp"
  • "image/webp"
  • "text/srt"
  • "text/vtt"
  • "image/tiff"
additional_owners[] Array No
shared Boolean No

Whether this media is shared or not.

Default value: false

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.