docs(api): use mintlify for API specs

docs/api-reference/users/add-roles.mdx

@@ -0,0 +1,7 @@
+---
+title: "Add Roles to User"
+api: "POST /api/v1/users/{id}/relationships/roles"
+description: "Assign roles to user."
+---
+
+Grant roles to a user for RBAC.

docs/api-reference/users/create.mdx

@@ -0,0 +1,20 @@
+---
+title: "Create User"
+api: "POST /api/v1/users"
+description: "Invite a new user to the tenant."
+---
+
+Create and invite a new user.
+
+## Request Body
+\`\`\`json
+{
+  "data": {
+    "type": "users",
+    "attributes": {
+      "email": "user@example.com",
+      "name": "John Doe"
+    }
+  }
+}
+\`\`\`

docs/api-reference/users/delete.mdx

@@ -0,0 +1,7 @@
+---
+title: "Delete User"
+api: "DELETE /api/v1/users/{id}"
+description: "Remove user from tenant."
+---
+
+Delete a user. This action cannot be undone.

docs/api-reference/users/list.mdx

@@ -0,0 +1,7 @@
+---
+title: "List Users"
+api: "GET /api/v1/users"
+description: "Retrieve all users in the tenant."
+---
+
+Get list of users with their roles and permissions.

docs/api-reference/users/me.mdx

@@ -0,0 +1,23 @@
+---
+title: "Get Current User"
+api: "GET /api/v1/users/me"
+description: "Retrieve information about the currently authenticated user."
+---
+
+Get profile information for the currently authenticated user including roles and permissions.
+
+## Example Request
+
+```bash
+curl -X GET "https://api.prowler.com/api/v1/users/me" \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+## Response
+
+Returns the current user's profile including email, roles, tenants, and permissions.
+
+<Note>
+Use this endpoint to verify authentication and retrieve user context for your application.
+</Note>

docs/api-reference/users/memberships-list.mdx

@@ -0,0 +1,7 @@
+---
+title: "List User Memberships"
+api: "GET /api/v1/users/{id}/memberships"
+description: "Get user's tenant memberships."
+---
+
+Retrieve tenants the user belongs to.

docs/api-reference/users/memberships-retrieve.mdx

@@ -0,0 +1,7 @@
+---
+title: "Retrieve User Membership"
+api: "GET /api/v1/users/{id}/memberships/{membership_id}"
+description: "Get specific membership details."
+---
+
+Fetch details about a user's membership in a tenant.

docs/api-reference/users/remove-roles.mdx

@@ -0,0 +1,7 @@
+---
+title: "Remove Roles from User"
+api: "DELETE /api/v1/users/{id}/relationships/roles"
+description: "Revoke roles from user."
+---
+
+Remove role assignments from a user.

docs/api-reference/users/retrieve.mdx

@@ -0,0 +1,7 @@
+---
+title: "Retrieve User"
+api: "GET /api/v1/users/{id}"
+description: "Get user details."
+---
+
+Fetch information about a specific user.

docs/api-reference/users/update-roles.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update User Roles"
+api: "PATCH /api/v1/users/{id}/relationships/roles"
+description: "Update user's assigned roles."
+---
+
+Modify user role assignments.

docs/api-reference/users/update.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update User"
+api: "PATCH /api/v1/users/{id}"
+description: "Update user information."
+---
+
+Modify user details or status.