Skip to main content
post/media/uploads

Upload message media

LLM
View as Markdown
Open llms.txt

Uploads a file and returns a `mediaId` handle for later message sends. Pass the handle as `content.media.mediaId` when sending media content. Use the same Idempotency-Key when retrying the same upload request.

Authorization

Scheme

  • bearerAuth

Required scopes

  • message:create

Allowed roles

  • owner
  • admin
  • agent

Upload media for a future message send.

Request body

  • Name
    multipart/form-data
    Type
    CreateMediaUploadRequest
    Description
    Required body.

Responses

  • 201

    Media uploaded

    • application/json MediaUploadResponse
  • default

    Error

    • application/json ProblemDetails