Matrix
Chat & messagingBearer tokenConnection test available
Matrix homeserver (Client-Server API) — create and manage rooms, send, search and redact messages and events, and upload or download media.
OCNORA ships 37 typed Matrix operations. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run.
Before you connect Matrix
- Authentication
- Bearer token
- Credential
- the account access token, or {"access_token": "…"}
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
What you can do with Matrix
Operations, grouped by what they do to your data.
Create and send 9
Read and search 14
Delete and cancel 1
Other operations 11
A sample Matrix workflow
- 1A core triggerStart the run from a chat, form, manual, schedule, webhook, workflow trigger — no Matrix trigger is needed.
- 2Download Mediamatrix.download_mediaDownload a file from the content repository as a base64 file payload.
- 3Ban Usermatrix.ban_userBan a user from a room, removing them and blocking rejoins.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 37
- Ban UserBan a user from a room, removing them and blocking rejoins.matrix.ban_user
- Reserve Media IDReserve an mxc:// URI now and upload its bytes later with matrix.upload_to_media_id.matrix.create_media_id
- Create RoomCreate a room and return its room id, optionally inviting members.matrix.create_room
- Create Room AliasPoint a room alias at a room on this homeserver.matrix.create_room_alias
- Delete Room AliasRemove a room alias mapping from this homeserver.matrix.delete_room_alias
- Download MediaDownload a file from the content repository as a base64 file payload.matrix.download_media
- Get EventRead a single event from a room by its event id.matrix.get_event
- Get Joined MembersRead the users currently joined to a room with their display names.matrix.get_joined_members
- Get Media ConfigRead the homeserver's media limits, including the maximum upload size.matrix.get_media_config
- Get MessagesRead a page of a room's timeline, newest first by default.matrix.get_messages
- Get ProfileRead a user's display name and avatar from their profile.matrix.get_profile
- Get Room StateRead a room's whole current state, or the content of one state event when an event type is given.matrix.get_room_state
- Preview URLAsk the homeserver for the OpenGraph preview of a web page.matrix.get_url_preview
- Invite UserInvite a user to a room.matrix.invite_user
- Join RoomJoin a room by its id or alias with the connection's account.matrix.join_room
- Kick UserRemove a user from a room; they may rejoin unless they are banned.matrix.kick_user
- Leave RoomLeave a room with the connection's account.matrix.leave_room
- List Joined RoomsList every room the connection's account is currently joined to.matrix.list_joined_rooms
- Search Public RoomsSearch the published room directory, on this or a remote homeserver.matrix.list_public_rooms
- List Room AliasesList this homeserver's local aliases for a room.matrix.list_room_aliases
- List Room MembersList a room's membership events, optionally filtered by membership state.matrix.list_room_members
- Redact EventRedact an event, stripping its content from the room's history.matrix.redact_event
- Resolve Room AliasTurn a room alias such as #ops:example.org into the room id sends need.matrix.resolve_room_alias
- Search MessagesFull-text search across room events the account can see.matrix.search_messages
- Search UsersSearch the homeserver's user directory by name or user id.matrix.search_users
- Send EventSend any room event type with a content object you supply.matrix.send_event
- Send Media MessagePost an already-uploaded file into a room as an image, file, audio or video message.matrix.send_media_message
- Send MessagePost a text message to a room, optionally as HTML or as a rich reply.matrix.send_message
- React to EventAdd an emoji reaction to an event as an m.reaction annotation.matrix.send_reaction
- Send Typing NotificationShow or clear the account's typing indicator in a room.matrix.send_typing
- Set Room StateWrite a state event — the room's name, topic, avatar, join rules or any custom state type.matrix.set_room_state
- Set Room Directory VisibilityPublish a room in this homeserver's room directory, or unpublish it.matrix.set_room_visibility
- Unban UserLift a user's ban so they can be invited or join again.matrix.unban_user
- Upgrade RoomReplace a room with a new one on a newer room version.matrix.upgrade_room
- Upload MediaUpload a file to the homeserver's content repository in one request.matrix.upload_media
- Upload to Reserved Media IDUpload a file's bytes into an mxc:// URI reserved earlier.matrix.upload_to_media_id
- Who Am IReport which Matrix account and device the access token belongs to.matrix.whoami
Matrix questions
- How does OCNORA authenticate with Matrix?
- With a stored Bearer token credential, shaped the account access token, or {"access_token": "…"}. A connection test can check it when you add it.
- What can I automate with Matrix?
- 37 typed operations, each with a reference page listing its config fields and the shapes it emits.
- What if the Matrix operation I need is not listed?
- Where Matrix has an HTTP API, call it from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use Matrix?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are Matrix calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
More in Chat & messaging
See your first Matrix workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.