POST: /media

Required authorization scope

When using OAuth2 access tokens, the media.post scope is required to post media. See scopes in the authentication guide for information about how to request this scope of authorization.

Request payload

The request body should be a multipart/form-data message, with a media field containing the raw binary image file to upload.

File specifications:

• Allowed file types: png, jpg, gif
• Max file size: 2MB

Example request

Here's an example of submitting a request using curl:

curl -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer OAUTH2_ACCESS_TOKEN' \
   --form [email protected] \
    https://api.proz.com/v2/media

Response

On success, a 201 Created HTTP status code will be returned, along with a JSON data structure like the following:

{
  "media_id": 12345,
  "size": 98865,
  "media_type": "image",
  "image": {
    "width": 125,
    "height": 150,
    "image_type": "image/jpeg"
  }
}

On error, a standard error response will be returned.