Desktop API Changelog

Find a version

All versions All versions forward

Version v4.1.210 (2025-09-17)

Added

• POST /v0/create-chat: create single or group chats using participant IDs, optional title, and initial message text (CreateChatOutput).
• POST /v0/download-asset: fetch Matrix mxc:// assets and return a local srcURL (DownloadAssetOutput). Assets (avatars, message attachments) return a local file path if they are already downloaded. This method can be used to download assets that are not yet downloaded.
• GET /v0/search: unified search returning top chats, participant matches, and first page of messages (UnifiedSearchOutput).
• GET /v0/search-users: look up contacts on a specific account before creating chats (SearchUsersOutput).

Changed

• POST /v0/open-app (OpenAppInput): new draftAttachmentPath; message jump now uses messageID.
• GET /v0/search-chats (SearchChatsInput): consolidated literal query, new scope toggle (titles vs participants), removed participantQuery, dropped channel from type, boolean filters now nullable.
• GET /v0/search-messages (SearchMessagesInput/SearchMessagesOutput): replaced onlyWith* flags with mediaTypes array (any/video/image/link/file); default page size documented as 20 with enforced cap; updated cursor examples; mute/low-priority filters nullable.
• POST /v0/send-message (SendMessageOutput): response returns chatID and pendingMessageID instead of a final messageID.

Removed

• POST /v0/download-attachment and GetAttachmentOutput superseded by the new download asset flow.