Update users endpoint to v2

mint.json

@@ -455,9 +455,23 @@
       ]
     },
     {
-      "group": "User endpoints",
+      "group": "Annotation endpoints",
       "pages": [
-        "restapi/endpoints/getCurrentUser"
+        "restapi/endpoints/getAnnotations",
+        "restapi/endpoints/getAnnotation",
+        "restapi/endpoints/createAnnotation",
+        "restapi/endpoints/updateAnnotation",
+        "restapi/endpoints/deleteAnnotation"
+      ]
+    },
+    {
+      "group": "API token endpoints",
+      "pages": [
+        "restapi/endpoints/getTokens",
+        "restapi/endpoints/getToken",
+        "restapi/endpoints/createToken",
+        "restapi/endpoints/regenerateToken",
+        "restapi/endpoints/deleteToken"
       ]
     },
     {
@@ -475,23 +489,14 @@
       ]
     },
     {
-      "group": "Annotation endpoints",
-      "pages": [
-        "restapi/endpoints/getAnnotations",
-        "restapi/endpoints/getAnnotation",
-        "restapi/endpoints/createAnnotation",
-        "restapi/endpoints/updateAnnotation",
-        "restapi/endpoints/deleteAnnotation"
-      ]
-    },
-    {
-      "group": "API token endpoints",
+      "group": "User endpoints",
       "pages": [
-        "restapi/endpoints/getTokens",
-        "restapi/endpoints/getToken",
-        "restapi/endpoints/createToken",
-        "restapi/endpoints/regenerateToken",
-        "restapi/endpoints/deleteToken"
+        "restapi/endpoints/getCurrentUser",
+        "restapi/endpoints/getUsers",
+        "restapi/endpoints/getUser",
+        "restapi/endpoints/createUser",
+        "restapi/endpoints/updateUser",
+        "restapi/endpoints/deleteUser"
       ]
     }
   ],

restapi/endpoints/createUser.mdx

@@ -0,0 +1,4 @@
+---
+title: Create user
+openapi: "v2 post /users"
+---

restapi/endpoints/deleteUser.mdx

@@ -0,0 +1,4 @@
+---
+title: Delete user
+openapi: "v2 delete /users/{id}"
+---

restapi/endpoints/getCurrentUser.mdx

@@ -1,4 +1,4 @@
 ---
 title: Retrieve current user
-openapi: "v1 get /user"
+openapi: "v2 get /user"
 ---

restapi/endpoints/getUser.mdx

@@ -0,0 +1,4 @@
+---
+title: Retrieve user
+openapi: "v2 get /users/{id}"
+---

restapi/endpoints/getUsers.mdx

@@ -0,0 +1,4 @@
+---
+title: List all users
+openapi: "v2 get /users"
+---

restapi/endpoints/updateUser.mdx

@@ -0,0 +1,10 @@
+---
+title: Update user
+openapi: "v2 put /users/{id}"
+---
+
+<Warning>
+Using this endpoint, you can change the name of your own user. Authorize the request with a [personal access token (PAT)](/reference/tokens).
+
+You cannot change the names of other users, you cannot change other properties than your name, and you cannot use an API token to authorize the request.
+</Warning>