Media

Upload files (images, videos, documents) to attach to wall posts. The flow is two-step:

  1. Upload the file via POST /media to receive a media object with an id.
  2. Reference the id in the media_ids array on POST /walls/{wall_id}/posts.

Required scope: write:media

Endpoints

POST
/api/open/v1/media

Upload a file (multipart/form-data)

GET
/api/open/v1/media/{id}

Get a media object by id

Upload request

Send as multipart/form-data:

FieldTypeNotes
mediafileRequired. The file to upload.
typestringRequired. One of image, video, document.

Size limit is governed by the server's media config — typically around 100 MB for video, smaller for images.

curl -X POST https://customer.monotree.com/api/open/v1/media \
  -H "Authorization: Bearer mono_your_token_here" \
  -F "media=@./photo.jpg" \
  -F "type=image"

Attach to a post

curl -X POST https://customer.monotree.com/api/open/v1/walls/1/posts \
  -H "Authorization: Bearer mono_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"body": "Look at this!", "media_ids": [42]}'

Response

{
  "data": {
    "id": 42,
    "type": "image",
    "mime_type": "image/jpeg",
    "filename": "photo.jpg",
    "size": 123456,
    "url": "https://cdn.monotree.dk/.../photo.jpg",
    "width": 1920,
    "height": 1080,
    "created_at": "2026-04-24T10:00:00+00:00"
  }
}