docs(api): use mintlify for API specs

docs/api-reference/roles/add-provider-groups.mdx

@@ -0,0 +1,7 @@
+---
+title: "Add Provider Groups to Role"
+api: "POST /api/v1/roles/{id}/relationships/provider_groups"
+description: "Associate provider groups with role."
+---
+
+Link provider groups to a role for scoped access.

docs/api-reference/roles/create.mdx

@@ -0,0 +1,20 @@
+---
+title: "Create Role"
+api: "POST /api/v1/roles"
+description: "Create a new RBAC role."
+---
+
+Create a custom role with specific permissions.
+
+## Request Body
+\`\`\`json
+{
+  "data": {
+    "type": "roles",
+    "attributes": {
+      "name": "Security Auditor",
+      "permissions": ["read:findings", "read:scans"]
+    }
+  }
+}
+\`\`\`

docs/api-reference/roles/delete.mdx

@@ -0,0 +1,7 @@
+---
+title: "Delete Role"
+api: "DELETE /api/v1/roles/{id}"
+description: "Remove a role."
+---
+
+Delete a custom role. Built-in roles cannot be deleted.

docs/api-reference/roles/list.mdx

@@ -0,0 +1,7 @@
+---
+title: "List Roles"
+api: "GET /api/v1/roles"
+description: "Retrieve RBAC roles."
+---
+
+Get all roles available in the tenant for role-based access control.

docs/api-reference/roles/remove-provider-groups.mdx

@@ -0,0 +1,7 @@
+---
+title: "Remove Provider Groups from Role"
+api: "DELETE /api/v1/roles/{id}/relationships/provider_groups"
+description: "Remove provider groups from role."
+---
+
+Disassociate provider groups from a role.

docs/api-reference/roles/retrieve.mdx

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

docs/api-reference/roles/update-provider-groups.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update Role Provider Groups"
+api: "PATCH /api/v1/roles/{id}/relationships/provider_groups"
+description: "Update role's provider groups."
+---
+
+Modify provider group associations for a role.

docs/api-reference/roles/update.mdx

@@ -0,0 +1,7 @@
+---
+title: "Update Role"
+api: "PATCH /api/v1/roles/{id}"
+description: "Update role permissions."
+---
+
+Modify role name or permissions.