9cff8a2707
... because there's nothing more infuriating than someone talking about an endpoint, then having to search through 150 pages of spec for it.
1.4 KiB
Client Config
Clients can store custom config data for their account on their homeserver. This account data will be synced between different devices and can persist across installations on a particular device. Users may only view the account data for their own account.
The account data may be either global or scoped to a particular room.
There is no inheritance mechanism here: a given type of data missing
from a room's account data does not fall back to the global account
data with the same type.
Events
The client receives the account data as events in the account_data
sections of a /sync response.
These events can also be received in a /events response or in the
account_data section of a room in a /sync response. m.tag events appearing in
/events will have a room_id with the room the tags are for.
Client Behaviour
{{% http-api spec="client-server" api="account-data" %}}
Server Behaviour
Servers MUST reject setting account data for event types
that the server manages by using a 405 error response.
Currently, this only includes m.fully_read
and m.push_rules. This applies to
both global and room-specific account data.
{{% boxes/note %}}
{{% changed-in v="1.10" %}} m.push_rules was added to the rejection
list.
{{% /boxes/note %}}
Servers must allow clients to read the above event types as normal.