From b1801ea6db61ac003054c42d17b9f55a06f1ec21 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Sun, 12 Nov 2017 23:49:40 -0700
Subject: [PATCH] Spec /account/whoami

Signed-off-by: Travis Ralston <travpc@gmail.com>
---
 api/client-server/whoami.yaml       | 54 +++++++++++++++++++++++++++++
 specification/client_server_api.rst |  5 +++
 2 files changed, 59 insertions(+)
 create mode 100644 api/client-server/whoami.yaml

diff --git a/api/client-server/whoami.yaml b/api/client-server/whoami.yaml
new file mode 100644
index 000000000..5b622f5c9
--- /dev/null
+++ b/api/client-server/whoami.yaml
@@ -0,0 +1,54 @@
+# Copyright 2017 Travis Ralston
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+swagger: '2.0'
+info:
+  title: "Matrix Client-Server Client Config 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:
+  "/account/whoami":
+    get:
+      summary: Gets information about the owner of an access token.
+      description: |-
+        Gets information about the owner of a given access token. Currently this
+        only supports returning the user id that owns the token.
+      security:
+        - accessToken: []
+      parameters: []
+      responses:
+        200:
+          description:
+            The account_data was successfully added.
+          examples:
+            application/json: {
+                "user_id": "@joe:example.org"
+              }
+          schema:
+            type: object
+            properties:
+              user_id:
+                type: string
+                description: The user id that owns the access token.
+      tags:
+        - User data
diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst
index 87e90150a..09f73bb94 100644
--- a/specification/client_server_api.rst
+++ b/specification/client_server_api.rst
@@ -786,6 +786,11 @@ This is independent of any information kept by any Identity Servers.
 
 {{administrative_contact_cs_http_api}}
 
+Current account information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+{{whoami_cs_http_api}}
+
 Pagination
 ----------