diff --git a/api/client-server/presence.yaml b/api/client-server/presence.yaml index ba202c2d..46134430 100644 --- a/api/client-server/presence.yaml +++ b/api/client-server/presence.yaml @@ -83,6 +83,8 @@ paths: description: |- Get the given user's presence state. operationId: getPresence + security: + - accessToken: [] parameters: - in: path type: string @@ -121,6 +123,15 @@ paths: description: |- There is no presence state for this user. This user may not exist or isn't exposing presence information to you. + 403: + description: You are not allowed to see this user's presence status. + examples: + application/json: { + "errcode": "M_FORBIDDEN", + "error": "You are not allowed to see their presence" + } + schema: + "$ref": "definitions/error.yaml" tags: - Presence "/presence/list/{userId}": diff --git a/changelogs/client_server.rst b/changelogs/client_server.rst index 32654025..c6c3ea7c 100644 --- a/changelogs/client_server.rst +++ b/changelogs/client_server.rst @@ -59,6 +59,8 @@ Unreleased changes (`#1245 `_). - Define what a ``RoomEvent`` is on ``/rooms/{roomId}/messages`` (`#1380 `_). + - Mark ``GET /presence/{userId}/status`` as requiring authentication + (`#1371 `_). - Describe ``StateEvent`` for ``/createRoom`` (`#1329 `_). - Describe how the ``reason`` is handled for kicks/bans