continuwuity/docs/reference/admin/query.md
Jade Ellis 2325e8fa4c
All checks were successful
Check Changelog / Check for changelog (pull_request_target) Successful in 9s
Documentation / Build and Deploy Documentation (pull_request) Successful in 1m30s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m25s
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m56s
Documentation / Build and Deploy Documentation (push) Successful in 1m31s
Checks / Prek / Pre-commit & Formatting (push) Successful in 1m17s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 8m27s
Checks / Prek / Clippy and Cargo Tests (push) Successful in 10m9s
Release Docker Image / Build linux-amd64 (release) (push) Successful in 13m13s
Release Docker Image / Build linux-arm64 (release) (push) Successful in 10m57s
Release Docker Image / Create Multi-arch Release Manifest (push) Successful in 20s
Release Docker Image / Build linux-arm64 (max-perf) (push) Successful in 34m54s
Release Docker Image / Build linux-amd64 (max-perf) (push) Successful in 35m45s
Release Docker Image / Create Max-Perf Manifest (push) Successful in 20s
chore: Update generated docs
2026-04-09 17:24:45 +01:00

4.2 KiB

!admin query

Low-level queries for database getters and iterators

!admin query account-data

account_data.rs iterators and getters

!admin query account-data changes-since

Returns all changes to the account data that happened after since

!admin query account-data account-data-get

Searches the account data for a specific kind

!admin query appservice

appservice.rs iterators and getters

!admin query appservice get-registration

Gets the appservice registration info/details from the ID as a string

!admin query appservice all

Gets all appservice registrations with their ID and registration info

!admin query presence

presence.rs iterators and getters

!admin query presence get-presence

Returns the latest presence event for the given user

!admin query presence presence-since

Iterator of the most recent presence updates that happened after the event with id since

!admin query room-alias

rooms/alias.rs iterators and getters

!admin query room-alias local-aliases-for-room

Iterator of all our local room aliases for the room ID

!admin query room-alias all-local-aliases

Iterator of all our local aliases in our database with their room IDs

!admin query room-state-cache

rooms/state_cache iterators and getters

!admin query room-timeline

rooms/timeline iterators and getters

!admin query globals

globals.rs iterators and getters

!admin query globals signing-keys-for

This returns an empty Ok(BTreeMap<..>) when there are no keys found for the server

!admin query sending

sending.rs iterators and getters

!admin query sending active-requests

Queries database for all servercurrentevent_data

!admin query sending active-requests-for

Queries database for servercurrentevent_data but for a specific destination

This command takes only one format of these arguments:

appservice_id server_name user_id AND push_key

See src/service/sending/mod.rs for the definition of the Destination enum

!admin query sending queued-requests

Queries database for servernameevent_data which are the queued up requests that will eventually be sent

This command takes only one format of these arguments:

appservice_id server_name user_id AND push_key

See src/service/sending/mod.rs for the definition of the Destination enum

!admin query users

users.rs iterators and getters

!admin query resolver

resolver service

!admin query resolver destinations-cache

Query the destinations cache

!admin query resolver overrides-cache

Query the overrides cache

!admin query resolver flush-cache

Flush a given server from the resolver caches or flush them completely

  • Examples:
    • Flush a specific server:

      !admin query resolver flush-cache matrix.example.com

    • Flush all resolver caches completely:

      !admin query resolver flush-cache --all

!admin query pusher

pusher service

!admin query pusher get-pushers

Returns all the pushers for the user

!admin query pusher delete-pusher

Deletes a specific pusher by ID

!admin query pusher delete-all-user

Deletes all pushers for a user

!admin query pusher delete-all-device

Deletes all pushers associated with a device ID

!admin query short

short service

!admin query raw

raw service

!admin query raw raw-maps

List database maps

!admin query raw raw-get

Raw database query

!admin query raw raw-del

Raw database delete (for string keys)

!admin query raw raw-keys

Raw database keys iteration

!admin query raw raw-keys-sizes

Raw database key size breakdown

!admin query raw raw-keys-total

Raw database keys total bytes

!admin query raw raw-vals-sizes

Raw database values size breakdown

!admin query raw raw-vals-total

Raw database values total bytes

!admin query raw raw-iter

Raw database items iteration

!admin query raw raw-keys-from

Raw database keys iteration

!admin query raw raw-iter-from

Raw database items iteration

!admin query raw raw-count

Raw database record count

!admin query raw compact

Compact database