Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-24 03:54:10 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
6797 commits 27 branches 42 tags 37 MiB
Commit graph

309 commits

Author SHA1 Message Date
Johannes Marbach c2b90d5084 Merge branch 'main' into johannes/reporting-rooms 2024-09-25 20:26:36 +02:00
Johannes Marbach 883e9e3f8c
Update data/api/client-server/report_content.yaml 
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
 2024-09-25 20:20:11 +02:00
Johannes Marbach 2cbf6067a6
Use "server name" instead of "DNS name" to avoid confusion (#1946) 
Fixes: #1911

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-09-11 08:56:14 -04:00
Johannes Marbach 75e77b96ff
Additional keys in GET /capabilities don't have to be objects (#1945) 2024-09-11 13:51:27 +02:00
Johannes Marbach 3aad778cab Add x-addedInMatrixVersion property 2024-09-09 08:13:02 +02:00
Kévin Commaille 415fb43848
Specify Content-Type and Content-Disposition usage in the media repo (#1935) 2024-09-02 10:41:33 +02:00
Johannes Marbach 7f2f100420
MSC4156: Migrate server_name to via (#1933) 
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-08-28 13:42:30 +01:00
Johannes Marbach fb719355d3 MSC4151: Reporting rooms 
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-08-26 09:31:26 +02:00
Tulir Asokan 87de68c35e
Fix required fields in /_matrix/key/v2/server response schema (#1930) 
Fixes #613
 2024-08-14 20:51:12 +03:00
Johannes Marbach f9c4aeeea4
Remove leftover origin field from unsigned PDU example (#1918) 2024-08-12 12:01:54 +01:00
Johannes Marbach c2fd278da0
Additional .well-known keys don't have to be objects (#1920) 2024-08-12 10:53:18 +01:00
Patrick Cloke 56914b72ef
Remove references to device-specific push rules. (#1842) 
Device-specific push rules have never been implemented and aren't properly specified.
 2024-08-01 10:33:41 -04:00
Johannes Marbach 9bac118aec
Clarify that the User identifier object in POST /_matrix/client/v3/login contains additional properties that depend on the identification type (#1909) 
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-07-30 17:37:49 +00:00
Johannes Marbach 5d91b628c9
Don't mention that GET /_matrix/client/v3/profile/{userId} can return additional properties because this is true for almost every endpoint (#1910) 
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-07-30 18:37:29 +01:00
Johannes Marbach d9c447e194
Document m.get_login_token capability (#1908) 2024-07-19 11:13:10 +01:00
Johannes Marbach cbe8092d8a
Spec for MSC2867 (Marking rooms as unread) (#1895) 
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
 2024-07-15 14:38:57 +01:00
Johannes Marbach 40d5e48716
Add missing references in capabilities table (#1897) 
* Add missing references in capabilities table

Fixes: #1548
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>

* Add changelog

---------

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-07-10 12:13:37 -04:00
Johannes Marbach d528ff684b
Fix minor typos in third-party networks module (#1892) 2024-06-28 08:14:32 -04:00
Johannes Marbach 7820771fdd
Clarify that room avatars cannot be encrypted (#1871) 
Fixes: #562
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-06-25 15:40:21 +01:00
Kévin Commaille bd20d946c4
Fix the rendering of the event format for room versions 1 and 2 (#1883) 
* Fix rendering of array with items using anyOf

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Use a single definition for Event Hash

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add changelog

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add ending newline

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

---------

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-06-20 09:39:44 -06:00
Kévin Commaille 094e25b6cd
Ensure more uniqueness for generated HTML IDs (#1881) 
* Include method in all API endpoint children's IDs

Avoids duplicate IDs for object of endpoints
that use the same path but a different method.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Differentiate API endpoints' request and response children's IDs

Ensures that the objects have a unique ID compared to other parts of the endpoint.
Mostly useful for the Error type that can be used for responses with different status codes.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Differentiate the names of both SessionData formats

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add changelog

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

---------

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-06-20 09:36:33 -06:00
Johannes Marbach 27e71fff10
Render added/changed in info on request and response content types (#1876) 
* Render added/changed in info on request and response content types

Fixes: #1774
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
Co-authored-by: Kévin Commaille <76261501+zecakeh@users.noreply.github.com>
 2024-06-20 09:46:33 +01:00
Kévin Commaille 4e32fca05f
Clarify that an access token is optional on /account/password and /account/deactivate (#1843) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
 2024-06-18 16:59:26 +01:00
Johannes Marbach 7773716d18
Clarify that asynchronous media upload requires authentication (#1872) 
Fixes: #1554
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-06-14 10:44:01 -04:00
Kévin Commaille f434fdfba7
Replace references to obsolete RFC 1341 with RFC 2046 (#1869) 
* Replace references to obsolete RFC 1341 with RFC 2046

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add changelog

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

---------

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-06-13 15:37:07 -06:00
Johannes Marbach 672af37cbd
Clarify that relations recursion should be capped at a certain depth (#1854) 2024-06-13 14:34:54 -04:00
Travis Ralston f38b052569
Use RFC 2119 keywords across the content repository spec (#1861) 
* Use RFC 2119 keywords across the content repository spec

* changelog
 2024-06-13 12:27:06 -06:00
Travis Ralston 7a51ae879c
Add authenticated media (MSC3916) (#1858) 
* C2S: Deprecate now-legacy endpoints

* C2S: Fix MXC URI code block while we're here

* C2S: Describe the authentication and deprecation requirements

* C2S: Intro the upload/download endpoints differently

* C2S: Literally copy/paste the `content-repo.yaml` spec

* C2S: Drop `/upload` and `/create` because we aren't replacing them today

* C2S: Fix notes while we're here

* C2S: Update metadata for new endpoints

* C2S: Add authentication to new endpoints

* C2S: Drop `allow_remote` and `allow_redirect` on new endpoints

* C2S: Append backwards compatibility notes

* C2S: Decorate old media endpoints with pointers to the new ones

The server-server spec might have a harder time linking to these, but that can be fixed with verbiage.

* C2S: Annotate IdP icon spec with media auth implications

* S2S: Modernize section text

* S2S: Create content repository API

This is largely a copy/paste of the new authed content repo API in the Client-Server API, though some keywords (like "client") have been changed. Paths and response formats have also been changed to support the federation-specific requirements.

* C2S & S2S: Add plethora of changelogs

* Reference RFC 1341

* Upgrade keywords in changed text

* Mention caching

* Cross-reference IdP icons

* Update content/client-server-api/modules/content_repo.md
 2024-06-13 18:08:27 +00:00
Patrick Cloke da3e884aaa
Fix broken link to push rule condition kinds. (#1841) 2024-06-11 21:42:46 +00:00
Patrick Cloke a7a7eadf2c
Clarify when an event is returned from /send_join. (#1840) 2024-06-11 13:02:46 -04:00
Richard van der Hoff 96057638ce
Spec unsigned.membership property, per MSC4115 (#1847) 2024-06-10 12:17:27 +00:00
Johannes Marbach 1b40a7789b
Fix typos around relations recursion (#1853) 2024-06-10 07:26:50 -04:00
Johannes Marbach 5a86e384dd
Clarify that per-request UIA for /login/get_token is an RFC 2119 MUST requirement (#1846) 
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
 2024-06-07 08:34:34 +00:00
Kévin Commaille 1e303b3bbc
Do not require UIA when first uploading cross-signing keys (#1828) 
As per MSC3967.
 2024-06-06 11:06:32 +01:00
Matthias Ahouansou 7ff785fc38
Clarify that the event field of the send_join is only required when performing a restricted join (#1834) 2024-06-03 14:09:40 +01:00
Kévin Commaille 3674985dd6
Factor out the common definitions of the content repo APIs and add new formats (#1822) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-05-28 15:38:39 +01:00
Kévin Commaille b0df8e7fb5
Use patternProperties in more places with supported formats (#1813) 
Allows to have more places where the property name's type is better defined.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-05-08 13:59:17 +00:00
Richard van der Hoff df1e799c51
Spec terms of service at registration (MSC1692) (#1812) 
Spec for matrix-org/matrix-spec-proposals#1692

Co-authored-by: Hubert Chathi <hubertc@matrix.org>
 2024-05-08 13:51:18 +00:00
Kévin Commaille 98d85cf421
Add support for rendering string formats (#1814) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-05-07 20:50:36 -04:00
Richard van der Hoff 48f4c4954f
Include information about additionalProperties in object tables (#1798) 
Currently, if we have an object which has additionalProperties in addition to properties, that information gets lost. This PR seeks to address that.
 2024-05-02 11:10:16 +01:00
Matthias Ahouansou eea3dfa969
Mention notifying AS for sender_localpart events (#1810) 
Signed-off-by: Matthias Ahouansou <matthias@ahouansou.cz>
 2024-05-01 10:48:11 +01:00
Kévin Commaille 2d18aac201
Use OneTimeKeys schema (#1800) 
This was commented prior to the
port to OpenAPI 3.1 for technical reasons (#1127).
Now we can use it just fine.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-04-30 18:13:05 +01:00
Kévin Commaille 625999a039
Deprecate authentication via a query string (#1808) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-04-30 17:07:59 +01:00
Kévin Commaille 2edfb21d5d
Add support for pattern formats for patternProperties (#1796) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-04-24 12:42:34 +01:00
Kévin Commaille 26ce3929b4
Clean up unecessary allOfs (#1797) 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
 2024-04-23 17:07:24 +01:00
Richard van der Hoff 2b5f990f60
Factor out common definition of Tag type (#1793) 
... and remove spurious `additionalProperties: true`
 2024-04-17 13:51:24 +01:00
Richard van der Hoff 073ce659df
Define opaque identifier grammar (#1791) 
Since we already have three of these, and I'm about to add a fourth, let's pull
it out to a common definition.

We could, of course, keep defining the grammar each time it's used, but
defining it in an appendix helps us be consistent for future API design.
 2024-04-17 09:22:06 +01:00
Kévin Commaille 2ea8e0f514
Remove enum for POST /login type definition (#1776) 
Since the enum is not exhaustive, improve the description of the property instead.
 2024-04-09 17:27:26 +01:00
Kévin Commaille efe72d3b26
Fix security schemes in OpenAPI definitions (#1772) 2024-04-09 18:12:30 +02:00
Travis Ralston d547154c91
Spec ?animated on /thumbnail (#1757) 
* Spec `?animated` on `/thumbnail`

* v3*

* v1.11
 2024-04-01 15:14:42 -06:00