Upload a file

The request body is the file itself, up to 20 MB. Send the real Content-Type, since the stored type comes from it. Returns the id to send in a message’s attachments, and the size and type it stored. The name is cut to 200 characters. HTML, XHTML, SVG and XSLT files upload, but a message that attaches one is refused. A message can be attachments alone with an empty body, and threads return each attachment with a download url.

curl -X POST "https://api.median.sh/v1/uploads?name=receipt.pdf" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -d '"<binary>"'

const response = await fetch("https://api.median.sh/v1/uploads?name=receipt.pdf", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/octet-stream"
  },
  body: JSON.stringify("<binary>")
});

{
  "attachmentId": "kg2f...",
  "name": "receipt.pdf",
  "size": 182044,
  "type": "application/pdf"
}

{
  "error": {
    "code": "file_too_big",
    "message": "Files have to be 20 MB or smaller."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "That Median key does not match any organization. Copy the median_key_ key again from Settings under API."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Your organization's API allowance is temporarily full. Please retry shortly."
  }
}