Add OS-KSCRUD api-ref

Change-Id: Ibf837eb880ee1811bfc85464b213451ddaf94a0b
Closes-Bug: 1524153

api-ref/source/v2-ext/index.rst

@@ -8,3 +8,4 @@
 
 .. include:: ksadm-admin.inc
 .. include:: ksec2-admin.inc
+.. include:: kscrud.inc

api-ref/source/v2-ext/kscrud.inc

@@ -0,0 +1,26 @@
+.. -*- rst -*-
+
+===================
+OS-KSCRUD extension
+===================
+
+Supports password changing for a user by themselves
+
+Change user's own password
+==========================
+
+.. rest_method::  PATCH /v2.0/OS-KSCRUD/users/{userId}
+
+Changes user's own password and returns the new token
+
+Normal response codes: 200
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+   - userId: userId
+   - user: user
+   - original_password: original_password
+   - password: new_password

api-ref/source/v2-ext/parameters.yaml

@@ -133,6 +133,18 @@ name_3:
   in: body
   required: true
   type: string
+new_password:
+  description: |
+    User's new password
+  in: body
+  required: true
+  type: string
+original_password:
+  description: |
+    User's old password
+  in: body
+  required: true
+  type: string
 roles:
   description: |
     A ``roles`` object.