XreplyAIDevelopers
API ReferenceMedia Uploads

Upload a Mastodon image

Requires scope: `publish:write`. Uploads a base64 image and returns a media reference for use in a post's metadata.

POST
/mastodon/media_uploads
AuthorizationBearer <token>

A personal API key created in the dashboard (Starter, Pro, and Team plans).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

media is accepted as an alias for image; when both are present, media wins.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/mastodon/media_uploads" \  -H "Content-Type: application/json" \  -d '{    "content_type": "string"  }'
{}