docs(api): use mintlify for API specs

docs/api-reference/tenants/create.mdx

@@ -0,0 +1,7 @@
+---
+title: "Create Tenant"
+api: "POST /api/v1/tenants"
+description: "Create a new tenant organization."
+---
+
+Create a new tenant (organization).

docs/api-reference/tenants/delete.mdx

@@ -0,0 +1,7 @@
+---
+title: "Delete Tenant"
+api: "DELETE /api/v1/tenants/{id}"
+description: "Remove a tenant."
+---
+
+Delete a tenant and all its data. This action cannot be undone.

docs/api-reference/tenants/invitations-create.mdx

@@ -0,0 +1,42 @@
+---
+title: "Create Tenant Invitation"
+api: "POST /api/v1/tenants/invitations"
+description: "Invite a user to join your tenant."
+---
+
+Send an invitation to a user to join your tenant.
+
+## Request Body
+
+```json
+{
+  "data": {
+    "type": "invitations",
+    "attributes": {
+      "email": "newuser@example.com",
+      "role": "member"
+    }
+  }
+}
+```
+
+## Example Request
+
+```bash
+curl -X POST "https://api.prowler.com/api/v1/tenants/invitations" \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
+  -H "Content-Type: application/vnd.api+json" \
+  -d '{
+    "data": {
+      "type": "invitations",
+      "attributes": {
+        "email": "newuser@example.com",
+        "role": "member"
+      }
+    }
+  }'
+```
+
+## Response
+
+Returns the created invitation.

docs/api-reference/tenants/invitations-list.mdx

@@ -0,0 +1,19 @@
+---
+title: "List Tenant Invitations"
+api: "GET /api/v1/tenants/invitations"
+description: "Retrieve pending invitations for the current tenant."
+---
+
+View all pending invitations sent from your tenant to other users.
+
+## Example Request
+
+```bash
+curl -X GET "https://api.prowler.com/api/v1/tenants/invitations" \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+## Response
+
+Returns a list of pending invitations.

docs/api-reference/tenants/invitations/delete.mdx

@@ -0,0 +1,7 @@
+---
+title: "Delete Tenant Invitation"
+api: "DELETE /api/v1/tenants/{id}/invitations/{invitation_id}"
+description: "Cancel invitation."
+---
+
+Cancel a pending invitation.

docs/api-reference/tenants/invitations/retrieve.mdx

@@ -0,0 +1,7 @@
+---
+title: "Retrieve Tenant Invitation"
+api: "GET /api/v1/tenants/{id}/invitations/{invitation_id}"
+description: "Get invitation details."
+---
+
+Fetch information about a specific invitation.

docs/api-reference/tenants/invitations/update.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update Tenant Invitation"
+api: "PATCH /api/v1/tenants/{id}/invitations/{invitation_id}"
+description: "Update invitation."
+---
+
+Modify invitation or resend.

docs/api-reference/tenants/list.mdx

@@ -0,0 +1,19 @@
+---
+title: "List Tenants"
+api: "GET /api/v1/tenants"
+description: "Retrieve a list of tenants you belong to."
+---
+
+Retrieve all tenants (organizations) that you are a member of.
+
+## Example Request
+
+```bash
+curl -X GET "https://api.prowler.com/api/v1/tenants" \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+## Response
+
+Returns a list of tenants with their details and your role in each.

docs/api-reference/tenants/memberships/delete.mdx

@@ -0,0 +1,7 @@
+---
+title: "Remove Tenant Membership"
+api: "DELETE /api/v1/tenants/{id}/memberships/{membership_id}"
+description: "Remove user from tenant."
+---
+
+Remove a user's membership from the tenant.

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

@@ -0,0 +1,7 @@
+---
+title: "List Tenant Memberships"
+api: "GET /api/v1/tenants/{id}/memberships"
+description: "Get all members of a tenant."
+---
+
+Retrieve users who are members of the tenant.

docs/api-reference/tenants/retrieve.mdx

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

docs/api-reference/tenants/update.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update Tenant"
+api: "PATCH /api/v1/tenants/{id}"
+description: "Update tenant settings."
+---
+
+Modify tenant name or configuration.