docs(okta): add manual description section to generated docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: waleedlatif1

apps/docs/content/docs/en/tools/okta.mdx

@@ -5,11 +5,30 @@ description: Manage users and groups in Okta
 
 import { BlockInfoCard } from "@/components/ui/block-info-card"
 
-<BlockInfoCard 
+<BlockInfoCard
   type="okta"
   color="#191919"
 />
 
+{/* MANUAL-CONTENT-START:intro */}
+[Okta](https://www.okta.com/) is an identity and access management platform that provides secure authentication, authorization, and user management for organizations.
+
+With the Okta integration in Sim, you can:
+
+- **List and search users**: Retrieve users from your Okta org with SCIM search expressions and filters
+- **Manage user lifecycle**: Create, activate, deactivate, suspend, unsuspend, and delete users
+- **Update user profiles**: Modify user attributes like name, email, phone, title, and department
+- **Reset passwords**: Trigger password reset flows with optional email notification
+- **Manage groups**: Create, update, delete, and list groups in your organization
+- **Manage group membership**: Add or remove users from groups, and list group members
+
+In Sim, the Okta integration enables your agents to automate identity management tasks as part of their workflows. This allows for scenarios such as onboarding new employees, offboarding departing users, managing group-based access, auditing user status, and responding to security events by suspending or deactivating accounts.
+
+## Need Help?
+
+If you encounter issues with the Okta integration, contact us at [help@sim.ai](mailto:help@sim.ai)
+{/* MANUAL-CONTENT-END */}
+
 ## Usage Instructions
 
 Integrate Okta identity management into your workflow. List, create, update, activate, suspend, and delete users. Reset passwords. Manage groups and group membership.