archive
/
matrix-spec
mirror of https://github.com/matrix-org/matrix-spec
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
main
release/v1.12
dbkr/msc4178
release/v1.11
tulir/msc4142
release/v1.10
travis/msc2702-msc2701
rav/ref_objects_in_params
dkasak/foldable-sidebar
travis/knock-join
release/v1.9
release/v1.8
anoa/update_docsy
anoa/nix_flake
dbkr/3077-multi-stream-voip
release/v1.7
dbkr/2746-reliable-voip
rav/links_for_object_defs
release/v1.6
release/v1.5
release/v1.4
anoa/invite_knock_room_state
release/v1.3
push_gateway/r0.1.0
r0.0.0
0.2.0
application_service/r0.1.0
application_service/r0.1.1
application_service/r0.1.2
client-server/0.3.0
client-server/r0.1.0
client-server/r0.2.0
client-server/r0.3.0
client_server/r0.4.0
client_server/r0.5.0
client_server/r0.6.0
client_server/r0.6.1
identity_service/r0.1.0
identity_service/r0.2.0
identity_service/r0.2.1
identity_service/r0.3.0
push_gateway/r0.1.1
r0.0.1
server_server/r0.1.0
server_server/r0.1.1
server_server/r0.1.2
server_server/r0.1.3
server_server/r0.1.4
v1.1
v1.10
v1.11
v1.12
v1.2
v1.3
v1.4
v1.5
v1.6
v1.7
v1.8
v1.9
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'fbbdd0f6cc'
${ noResults }
matrix-spec/proposals/2320-identity-versions.md

1.2 KiB
Raw Blame History

Versions information for identity servers

The client-server API currently specifies a /versions endpoint that allows clients to know what version of that API are implemented by the server. Identity servers could benefit from that endpoint as both homeservers and clients interact with them, and therefore could know which features they can expect a given identity server to implement by looking at the versions of the API it claims to support.

Proposal

This proposal adds the following endpoint to the identity server API.

GET /_matrix/identity/versions

This endpoint serves information about the versions of the identity server API this identity server supports. Its response uses the following format:

{
    "versions": [
        "r0.1.0",
        "r0.2.0",
        "r0.2.1",
    ]
}

Alternative solutions

Another solution which was considered was using the status check endpoint (GET /_matrix/api/v1) to serve this information. This solution was discarded because it's using a versioned endpoint, which doesn't make sense to advertise the supported versions of the API to use.