Document the /logout api

We have one, and it's useful, so we really ought to document it

api/client-server/logout.yaml

@@ -0,0 +1,32 @@
+swagger: '2.0'
+info:
+  title: "Matrix Client-Server Registration and Login API"
+  version: "1.0.0"
+host: localhost:8008
+schemes:
+  - https
+  - http
+basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+consumes:
+  - application/json
+produces:
+  - application/json
+securityDefinitions:
+  $ref: definitions/security.yaml
+paths:
+  "/logout":
+    post:
+      summary: Invalidates a user access token
+      description: |-
+        Invalidates an existing access token, so that it can no longer be used for
+        authorization.
+      security:
+        - accessToken: []
+      responses:
+        200:
+          description: The access token used in the request was succesfully invalidated.
+          schema:
+            type: object
+            properties: []
+      tags:
+        - Session management

changelogs/client_server.rst

@@ -24,6 +24,7 @@ This release includes the following changes since r0.0.1:
 
   - New endpoints:
 
+    - ``POST /logout``
     - ``POST /rooms/{roomId}/unban``
     - ``POST /rooms/{roomId}/kick``
     - ``GET /pushers``

specification/client_server_api.rst

@@ -528,6 +528,8 @@ homeserver must respond with 403 Forbidden.
 
 {{login_cs_http_api}}
 
+{{logout_cs_http_api}}
+
 Login Fallback
 <<<<<<<<<<<<<<