{"slug":"matrix-org-homeserver-api","name":"Matrix.org homeserver API","host":"matrix-client.matrix.org","site":"https://matrix.org","category":"communication","docsUrl":null,"sources":[{"kind":"changelog","url":"https://spec.matrix.org/latest/changelog/"},{"kind":"archive","url":"https://spec.matrix.org/latest/client-server-api/"}],"url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/","json":"https://www.okapi.bot/api/v1/providers/matrix-org-homeserver-api.json","breakingChanges":[{"slug":"get-matrix-client-v3-events-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/client/v3/events is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/client/v3/events"],"method":"GET","path":"/_matrix/client/v3/events","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This endpoint was deprecated in r0 of this specification. Clients should instead call the /sync endpoint with a since parameter.","migration":"Call GET /_matrix/client/v3/sync with a since parameter instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-client-v3-events-is-deprecated/"},{"slug":"get-matrix-client-v3-events-is-deprecated-2","api":"matrix-org-homeserver-api","title":"GET /_matrix/client/v3/events/{} is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/client/v3/events/{}"],"method":"GET","path":"/_matrix/client/v3/events/{}","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"Clients should instead call the /rooms/{roomId}/event/{eventId} API or the /rooms/{roomId}/context/{eventId} API.","migration":"Call GET /_matrix/client/v3/rooms/{roomId}/event/{eventId} instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-client-v3-events-is-deprecated-2/"},{"slug":"get-matrix-client-v3-initialsync-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/client/v3/initialSync is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/client/v3/initialSync"],"method":"GET","path":"/_matrix/client/v3/initialSync","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This endpoint was deprecated in r0 of this specification. Clients should instead call the /sync endpoint with no since parameter.","migration":"Call GET /_matrix/client/v3/sync with no since parameter instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-client-v3-initialsync-is-deprecated/"},{"slug":"get-matrix-media-v3-config-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/media/v3/config is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/media/v3/config"],"method":"GET","path":"/_matrix/media/v3/config","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This API is deprecated and will be removed from a future release. Replaced by GET /_matrix/client/v1/media/config","migration":"Call GET /_matrix/client/v1/media/config with an access token.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-media-v3-config-is-deprecated/"},{"slug":"get-matrix-media-v3-download-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/media/v3/download/* is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/media/v3/download/*"],"method":"GET","path":"/_matrix/media/v3/download/*","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This API is deprecated and will be removed from a future release. Replaced by GET /_matrix/client/v1/media/download/{serverName}/{mediaId} (requires authentication)","migration":"Call GET /_matrix/client/v1/media/download/{serverName}/{mediaId} with an access token; on matrix.org, media uploaded after the September 2024 freeze is only served there.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-media-v3-download-is-deprecated/"},{"slug":"get-matrix-media-v3-preview-url-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/media/v3/preview_url is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/media/v3/preview_url"],"method":"GET","path":"/_matrix/media/v3/preview_url","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This API is deprecated and will be removed from a future release. Replaced by GET /_matrix/client/v1/media/preview_url","migration":"Call GET /_matrix/client/v1/media/preview_url with an access token.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-media-v3-preview-url-is-deprecated/"},{"slug":"get-matrix-media-v3-thumbnail-is-deprecated","api":"matrix-org-homeserver-api","title":"GET /_matrix/media/v3/thumbnail/{}/{} is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /_matrix/media/v3/thumbnail/{}/{}"],"method":"GET","path":"/_matrix/media/v3/thumbnail/{}/{}","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This API is deprecated and will be removed from a future release. Replaced by GET /_matrix/client/v1/media/thumbnail/{serverName}/{mediaId} (requires authentication)","migration":"Call GET /_matrix/client/v1/media/thumbnail/{serverName}/{mediaId} with an access token.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/get-matrix-media-v3-thumbnail-is-deprecated/"},{"slug":"post-matrix-client-v3-account-3pid-is-deprecated","api":"matrix-org-homeserver-api","title":"POST /_matrix/client/v3/account/3pid is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["POST /_matrix/client/v3/account/3pid"],"method":"POST","path":"/_matrix/client/v3/account/3pid","source":{"url":"https://spec.matrix.org/latest/client-server-api/","kind":"archive"},"quote":"This endpoint is deprecated in favour of the more specific /3pid/add and /3pid/bind endpoints.","migration":"Call POST /_matrix/client/v3/account/3pid/add or /account/3pid/bind instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:19:05.254Z","updatedAt":"2026-10-23T10:19:05.254Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/matrix-org-homeserver-api/breaking-changes/post-matrix-client-v3-account-3pid-is-deprecated/"}]}