Merge pull request #1 from wekan/master

Update master

2 files changed, 142 insertions, 4 deletions

diff --git a/public/api/wekan.html b/public/api/wekan.html
index e7cbaf8d..a746228f 100644
--- a/public/api/wekan.html
+++ b/public/api/wekan.html
@@ -1524,7 +1524,7 @@ var n=this.pipeline.run(e.tokenizer(t)),r=new e.Vector,i=[],o=this._fields.reduc
 	  	<ul class="toc-list-h1">
         
           <li>
-            <a href="#wekan-rest-api" class="toc-h1 toc-link" data-title="Wekan REST API v3.24">Wekan REST API v3.24</a>
+            <a href="#wekan-rest-api" class="toc-h1 toc-link" data-title="Wekan REST API v3.55">Wekan REST API v3.55</a>
             
           </li>
         
@@ -2017,7 +2017,7 @@ var n=this.pipeline.run(e.tokenizer(t)),r=new e.Vector,i=[],o=this._fields.reduc
     <div class="page-wrapper">
       <div class="dark-box"></div>
       <div class="content">
-        <h1 id="wekan-rest-api">Wekan REST API v3.24</h1>
+        <h1 id="wekan-rest-api">Wekan REST API v3.55</h1>
 <blockquote>
 <p>Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.</p>
 </blockquote>
@@ -4479,7 +4479,8 @@ $.ajax({
 </code></pre>
 <pre class="highlight tab tab-javascript--nodejs"><code><span class="hljs-keyword">const</span> fetch = <span class="hljs-built_in">require</span>(<span class="hljs-string">'node-fetch'</span>);
 <span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">'{
-  "title": "string"
+  "title": "string",
+  "items": "string"
 }'</span>;
 <span class="hljs-keyword">const</span> headers = {
   <span class="hljs-string">'Content-Type'</span>:<span class="hljs-string">'multipart/form-data'</span>,
@@ -4573,6 +4574,7 @@ System.out.println(response.toString());
 <p>Body parameter</p>
 </blockquote>
 <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
+<span class="hljs-attr">items:</span> <span class="hljs-string">string</span>
 
 </code></pre>
 <h3 id="post_board_card_checklists-parameters">Parameters</h3>
@@ -4615,6 +4617,13 @@ System.out.println(response.toString());
 <td>true</td>
 <td>the title value</td>
 </tr>
+<tr>
+<td>» items</td>
+<td>body</td>
+<td>string</td>
+<td>true</td>
+<td>the items value</td>
+</tr>
 </tbody>
 </table>
 <h3 id="post_board_card_checklists-responses">Responses</h3>
@@ -9350,6 +9359,7 @@ System.out.println(response.toString());
 </blockquote>
 <pre class="highlight tab tab-json"><code>{
   <span class="hljs-attr">"title"</span>: <span class="hljs-string">"string"</span>,
+  <span class="hljs-attr">"starred"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"archived"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"boardId"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"swimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -9870,6 +9880,7 @@ $.ajax({
 <span class="hljs-keyword">const</span> inputBody = <span class="hljs-string">'{
   "authorId": "string",
   "members": "string",
+  "assignees": "string",
   "title": "string",
   "description": "string",
   "swimlaneId": "string"
@@ -9972,6 +9983,7 @@ System.out.println(response.toString());
 </blockquote>
 <pre class="highlight tab tab-yaml"><code><span class="hljs-attr">authorId:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">members:</span> <span class="hljs-string">string</span>
+<span class="hljs-attr">assignees:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">title:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">swimlaneId:</span> <span class="hljs-string">string</span>
@@ -10025,6 +10037,13 @@ System.out.println(response.toString());
 <td>the member IDs list of the new card</td>
 </tr>
 <tr>
+<td>» assignees</td>
+<td>body</td>
+<td>string</td>
+<td>false</td>
+<td>the array of maximum one ID of assignee of the new card</td>
+</tr>
+<tr>
 <td>» title</td>
 <td>body</td>
 <td>string</td>
@@ -10330,6 +10349,7 @@ $.ajax({
   "isOverTime": "string",
   "customFields": "string",
   "members": "string",
+  "assignees": "string",
   "swimlaneId": "string"
 }'</span>;
 <span class="hljs-keyword">const</span> headers = {
@@ -10440,6 +10460,7 @@ System.out.println(response.toString());
 <span class="hljs-attr">isOverTime:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">customFields:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">members:</span> <span class="hljs-string">string</span>
+<span class="hljs-attr">assignees:</span> <span class="hljs-string">string</span>
 <span class="hljs-attr">swimlaneId:</span> <span class="hljs-string">string</span>
 
 </code></pre>
@@ -10603,6 +10624,13 @@ System.out.println(response.toString());
 <td>the members value</td>
 </tr>
 <tr>
+<td>» assignees</td>
+<td>body</td>
+<td>string</td>
+<td>true</td>
+<td>the assignees value</td>
+</tr>
+<tr>
 <td>» swimlaneId</td>
 <td>body</td>
 <td>string</td>
@@ -11593,6 +11621,7 @@ System.out.println(response.toString());
       <span class="hljs-string">"string"</span>
     ],
     <span class="hljs-attr">"fullname"</span>: <span class="hljs-string">"string"</span>,
+    <span class="hljs-attr">"showDesktopDragHandles"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenSystemMessages"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenMinicardLabelText"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"initials"</span>: <span class="hljs-string">"string"</span>,
@@ -11609,6 +11638,7 @@ System.out.println(response.toString());
     ],
     <span class="hljs-attr">"icode"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"boardView"</span>: <span class="hljs-string">"board-view-lists"</span>,
+    <span class="hljs-attr">"listSortBy"</span>: <span class="hljs-string">"-modifiedat"</span>,
     <span class="hljs-attr">"templatesBoardId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"cardTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"listTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -12246,6 +12276,7 @@ System.out.println(response.toString());
       <span class="hljs-string">"string"</span>
     ],
     <span class="hljs-attr">"fullname"</span>: <span class="hljs-string">"string"</span>,
+    <span class="hljs-attr">"showDesktopDragHandles"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenSystemMessages"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenMinicardLabelText"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"initials"</span>: <span class="hljs-string">"string"</span>,
@@ -12262,6 +12293,7 @@ System.out.println(response.toString());
     ],
     <span class="hljs-attr">"icode"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"boardView"</span>: <span class="hljs-string">"board-view-lists"</span>,
+    <span class="hljs-attr">"listSortBy"</span>: <span class="hljs-string">"-modifiedat"</span>,
     <span class="hljs-attr">"templatesBoardId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"cardTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"listTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -14150,6 +14182,9 @@ UserSecurity
   <span class="hljs-attr">"members"</span>: [
     <span class="hljs-string">"string"</span>
   ],
+  <span class="hljs-attr">"assignees"</span>: [
+    <span class="hljs-string">"string"</span>
+  ],
   <span class="hljs-attr">"receivedAt"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"startAt"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"dueAt"</span>: <span class="hljs-string">"string"</span>,
@@ -14296,6 +14331,13 @@ UserSecurity
 <td>list of members (user IDs)</td>
 </tr>
 <tr>
+<td>assignees</td>
+<td>[string]|null</td>
+<td>false</td>
+<td>none</td>
+<td>who is assignee of the card (user ID), maximum one ID of assignee in array.</td>
+</tr>
+<tr>
 <td>receivedAt</td>
 <td>string|null</td>
 <td>false</td>
@@ -14908,6 +14950,7 @@ UserSecurity
 <p><a id="schemalists"></a></p>
 <pre class="highlight tab tab-json"><code>{
   <span class="hljs-attr">"title"</span>: <span class="hljs-string">"string"</span>,
+  <span class="hljs-attr">"starred"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"archived"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"boardId"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"swimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -14946,6 +14989,13 @@ UserSecurity
 <td>the title of the list</td>
 </tr>
 <tr>
+<td>starred</td>
+<td>boolean|null</td>
+<td>false</td>
+<td>none</td>
+<td>if a list is stared then we put it on the top</td>
+</tr>
+<tr>
 <td>archived</td>
 <td>boolean</td>
 <td>true</td>
@@ -15386,6 +15436,7 @@ UserSecurity
       <span class="hljs-string">"string"</span>
     ],
     <span class="hljs-attr">"fullname"</span>: <span class="hljs-string">"string"</span>,
+    <span class="hljs-attr">"showDesktopDragHandles"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenSystemMessages"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"hiddenMinicardLabelText"</span>: <span class="hljs-literal">true</span>,
     <span class="hljs-attr">"initials"</span>: <span class="hljs-string">"string"</span>,
@@ -15402,6 +15453,7 @@ UserSecurity
     ],
     <span class="hljs-attr">"icode"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"boardView"</span>: <span class="hljs-string">"board-view-lists"</span>,
+    <span class="hljs-attr">"listSortBy"</span>: <span class="hljs-string">"-modifiedat"</span>,
     <span class="hljs-attr">"templatesBoardId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"cardTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
     <span class="hljs-attr">"listTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -15552,6 +15604,7 @@ UserSecurity
     <span class="hljs-string">"string"</span>
   ],
   <span class="hljs-attr">"fullname"</span>: <span class="hljs-string">"string"</span>,
+  <span class="hljs-attr">"showDesktopDragHandles"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"hiddenSystemMessages"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"hiddenMinicardLabelText"</span>: <span class="hljs-literal">true</span>,
   <span class="hljs-attr">"initials"</span>: <span class="hljs-string">"string"</span>,
@@ -15568,6 +15621,7 @@ UserSecurity
   ],
   <span class="hljs-attr">"icode"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"boardView"</span>: <span class="hljs-string">"board-view-lists"</span>,
+  <span class="hljs-attr">"listSortBy"</span>: <span class="hljs-string">"-modifiedat"</span>,
   <span class="hljs-attr">"templatesBoardId"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"cardTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
   <span class="hljs-attr">"listTemplatesSwimlaneId"</span>: <span class="hljs-string">"string"</span>,
@@ -15609,6 +15663,13 @@ UserSecurity
 <td>full name of the user</td>
 </tr>
 <tr>
+<td>showDesktopDragHandles</td>
+<td>boolean</td>
+<td>false</td>
+<td>none</td>
+<td>does the user want to hide system messages?</td>
+</tr>
+<tr>
 <td>hiddenSystemMessages</td>
 <td>boolean</td>
 <td>false</td>
@@ -15679,6 +15740,13 @@ UserSecurity
 <td>boardView field of the user</td>
 </tr>
 <tr>
+<td>listSortBy</td>
+<td>string</td>
+<td>false</td>
+<td>none</td>
+<td>default sort list for user</td>
+</tr>
+<tr>
 <td>templatesBoardId</td>
 <td>string</td>
 <td>true</td>
@@ -15729,6 +15797,30 @@ UserSecurity
 <td>boardView</td>
 <td>board-view-cal</td>
 </tr>
+<tr>
+<td>listSortBy</td>
+<td>-modifiedat</td>
+</tr>
+<tr>
+<td>listSortBy</td>
+<td>modifiedat</td>
+</tr>
+<tr>
+<td>listSortBy</td>
+<td>-title</td>
+</tr>
+<tr>
+<td>listSortBy</td>
+<td>title</td>
+</tr>
+<tr>
+<td>listSortBy</td>
+<td>-sort</td>
+</tr>
+<tr>
+<td>listSortBy</td>
+<td>sort</td>
+</tr>
 </tbody>
 </table>
 
diff --git a/public/api/wekan.yml b/public/api/wekan.yml
index a28b54e4..08463950 100644
--- a/public/api/wekan.yml
+++ b/public/api/wekan.yml
@@ -1,7 +1,7 @@
 swagger: '2.0'
 info:
   title: Wekan REST API
-  version: v3.24
+  version: v3.55
   description: |
     The REST API allows you to control and extend Wekan with ease.
 
@@ -319,6 +319,11 @@ paths:
           description: the title value
           type: string
           required: true
+        - name: items
+          in: formData
+          description: the items value
+          type: string
+          required: true
         - name: board
           in: path
           description: the board value
@@ -1268,6 +1273,12 @@ paths:
             the member IDs list of the new card
           type: string
           required: false
+        - name: assignees
+          in: formData
+          description: |
+            the array of maximum one ID of assignee of the new card
+          type: string
+          required: false
         - name: title
           in: formData
           description: |
@@ -1433,6 +1444,11 @@ paths:
           description: the members value
           type: string
           required: true
+        - name: assignees
+          in: formData
+          description: the assignees value
+          type: string
+          required: true
         - name: swimlaneId
           in: formData
           description: the swimlaneId value
@@ -2349,6 +2365,15 @@ definitions:
           type: string
           x-nullable: true
         x-nullable: true
+      assignees:
+        description: |
+           who is assignee of the card (user ID),
+           maximum one ID of assignee in array.
+        type: array
+        items:
+          type: string
+          x-nullable: true
+        x-nullable: true
       receivedAt:
         description: |
            Date the card was received
@@ -2606,6 +2631,12 @@ definitions:
         description: |
            the title of the list
         type: string
+      starred:
+        description: |
+           if a list is stared
+           then we put it on the top
+        type: boolean
+        x-nullable: true
       archived:
         description: |
            is the list archived
@@ -2865,6 +2896,10 @@ definitions:
         description: |
            full name of the user
         type: string
+      showDesktopDragHandles:
+        description: |
+           does the user want to hide system messages?
+        type: boolean
       hiddenSystemMessages:
         description: |
            does the user want to hide system messages?
@@ -2918,6 +2953,17 @@ definitions:
           - board-view-lists
           - board-view-swimlanes
           - board-view-cal
+      listSortBy:
+        description: |
+           default sort list for user
+        type: string
+        enum:
+          - -modifiedat
+          - modifiedat
+          - -title
+          - title
+          - -sort
+          - sort
       templatesBoardId:
         description: |
            Reference to the templates board