# POST /api/v1/media is deprecated

Mastodon API deprecated POST /api/v1/media without giving a shutdown date yet.

- API: Mastodon API (mastodon.social)
- Kind: Version retirement
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /api/v1/media`
- Source: [Announcement](https://docs.joinmastodon.org/methods/media/)
- Page: https://www.okapi.bot/providers/mastodon-api/breaking-changes/post-api-v1-media-is-deprecated/

## What to use instead

Upload with POST /api/v2/media and poll GET /api/v1/media/{id} until the url is set.

## Mastodon API's words

> 3.1.3 - deprecated in favor of POST /api/v2/media , which is equal to v1 in all aspects, except it returns HTTP 202