@workos/mcp-docs-server 0.1.0 → 0.2.0

package/.docs/organized/docs/events/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Events
-description: "Respond to activity that occurs within WorkOS and third-party\_providers."
+description: Respond to activity that occurs within WorkOS and third-party providers.
 originalPath: .tmp-workos-clone/packages/docs/content/events/index.mdx
 ---
 
@@ -16,10 +16,29 @@ All event objects share a similar structure.
 | `id`         | Unique identifier for the event.                                           |
 | `data`       | Event payload. Payloads match the corresponding [API objects](/reference). |
 | `created_at` | Timestamp of when the event occurred.                                      |
+| `context`    | An optional object of extra information relevant to the event.             |
+
+## API key events {{ "url": "api-key" }}
+
+Events emitted when [API keys](/authkit/api-keys) are created or revoked.
+
+<Event.Root>
+  <Event.Details name="api_key.created">
+    <CodeBlock title="API key created event" file="event-api-key-created" />
+  </Event.Details>
+  <Event.Description>Triggered when an API key is created.</Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="api_key.revoked">
+    <CodeBlock title="API key revoked event" file="event-api-key-revoked" />
+  </Event.Details>
+  <Event.Description>Triggered when an API key is revoked.</Event.Description>
+</Event.Root>
 
 ## Authentication events {{ "url": "authentication" }}
 
-Each step in the [authentication](/reference/user-management/authentication) flow emits an authentication event. Authentication success events are emitted even when additional steps, such as MFA, are required to complete the process.
+Each step in the [authentication](/reference/authkit/authentication) flow emits an authentication event. Authentication success events are emitted even when additional steps, such as MFA, are required to complete the process.
 
 <Event.Root mt="5">
   <Event.Details name="authentication.email_verification_failed" comingSoon>
@@ -388,7 +407,9 @@ Events emitted when directory-related resources are changed. To learn what exact
       Payload `data` contains a `user` which corresponds to the [Directory
       User](/reference/directory-sync/directory-user) object and a `group` which
       corresponds to the [Directory
-      Group](/reference/directory-sync/directory-group) object.
+      Group](/reference/directory-sync/directory-group) object. The `groups`
+      field is omitted from the `user` object to avoid performance issues in
+      large directories.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -407,7 +428,9 @@ Events emitted when directory-related resources are changed. To learn what exact
       Payload `data` contains a `user` which corresponds to the [Directory
       User](/reference/directory-sync/directory-user) object and a `group` which
       corresponds to the [Directory
-      Group](/reference/directory-sync/directory-group) object.
+      Group](/reference/directory-sync/directory-group) object. The `groups`
+      field is omitted from the `user` object to avoid performance issues in
+      large directories.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -424,7 +447,8 @@ Events emitted when directory-related resources are changed. To learn what exact
     />
     <Event.Description>
       Payload `data` corresponds to the [Directory
-      User](/reference/directory-sync/directory-user) object.
+      User](/reference/directory-sync/directory-user) object. The `groups` field
+      is omitted to avoid performance issues in large directories.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -441,7 +465,8 @@ Events emitted when directory-related resources are changed. To learn what exact
     />
     <Event.Description>
       Payload `data` corresponds to the [Directory
-      User](/reference/directory-sync/directory-user) object.
+      User](/reference/directory-sync/directory-user) object. The `groups` field
+      is omitted to avoid performance issues in large directories.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -459,7 +484,8 @@ Events emitted when directory-related resources are changed. To learn what exact
     />
     <Event.Description>
       Payload `data` corresponds to the [Directory
-      User](/reference/directory-sync/directory-user) object.
+      User](/reference/directory-sync/directory-user) object. The `groups` field
+      is omitted to avoid performance issues in large directories.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -480,8 +506,7 @@ Events emitted when a user is required to verify their email.
     />
     <Event.Description>
       Payload `data` corresponds to the [Email
-      verification](/user-management/email-verification) object with the `code`
-      omitted.
+      verification](/authkit/email-verification) object with the `code` omitted.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -490,9 +515,94 @@ Events emitted when a user is required to verify their email.
   </Event.Description>
 </Event.Root>
 
+## Feature flag events {{ "url": "feature-flags" }}
+
+Events emitted when WorkOS feature flags are created, updated, deleted, or their rules are updated.
+
+<Event.Root>
+  <Event.Details name="flag.created">
+    <CodeBlock
+      title="Feature flag created event"
+      file="event-feature-flag-created"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Feature Flag](/reference/feature-flags)
+      object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when a feature flag is created.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="flag.updated">
+    <CodeBlock
+      title="Feature flag updated event"
+      file="event-feature-flag-updated"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Feature Flag](/reference/feature-flags)
+      object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when a feature flag is updated.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="flag.deleted">
+    <CodeBlock
+      title="Feature flag deleted event"
+      file="event-feature-flag-deleted"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Feature Flag](/reference/feature-flags)
+      object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when a feature flag is deleted.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="flag.rule_updated">
+    <CodeBlock
+      title="Feature flag rule updated event"
+      file="event-feature-flag-rule-updated"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Feature Flag](/reference/feature-flags)
+      object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when a feature flag's rules are modified.
+  </Event.Description>
+</Event.Root>
+
 ## Invitation events {{ "url": "invitation" }}
 
-Events emitted when a [User Management user](/reference/user-management/user) is invited to join an organization.
+Events emitted when an [AuthKit user](/reference/authkit/user) is invited to join an organization.
+
+<Event.Root>
+  <Event.Details name="invitation.accepted">
+    <CodeBlock
+      title="Invitation accepted event"
+      file="event-invitation-accepted"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the
+      [Invitation](/reference/authkit/invitation) object with the `token` and
+      `accept_invitation_url` omitted.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when a user accepts an invitation.
+  </Event.Description>
+</Event.Root>
 
 <Event.Root>
   <Event.Details name="invitation.created">
@@ -502,8 +612,8 @@ Events emitted when a [User Management user](/reference/user-management/user) is
     />
     <Event.Description>
       Payload `data` corresponds to the
-      [Invitation](/reference/user-management/invitation) object with the
-      `token` omitted.
+      [Invitation](/reference/authkit/invitation) object with the `token` and
+      `accept_invitation_url` omitted.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -511,6 +621,35 @@ Events emitted when a [User Management user](/reference/user-management/user) is
   </Event.Description>
 </Event.Root>
 
+<Event.Root>
+  <Event.Details name="invitation.resent">
+    <CodeBlock title="Invitation resent event" file="event-invitation-resent" />
+    <Event.Description>
+      Payload `data` corresponds to the
+      [Invitation](/reference/authkit/invitation) object with the `token` and
+      `accept_invitation_url` omitted.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>Triggered when an invitation is resent.</Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="invitation.revoked">
+    <CodeBlock
+      title="Invitation revoked event"
+      file="event-invitation-revoked"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the
+      [Invitation](/reference/authkit/invitation) object with the `token` and
+      `accept_invitation_url` omitted.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an invitation is revoked.
+  </Event.Description>
+</Event.Root>
+
 ## Magic Auth events {{ "url": "magic-auth" }}
 
 Events emitted when a user requests a Magic Auth code.
@@ -523,8 +662,7 @@ Events emitted when a user requests a Magic Auth code.
     />
     <Event.Description>
       Payload `data` corresponds to the [Magic
-      Auth](/reference/user-management/magic-auth) object with the `code`
-      omitted.
+      Auth](/reference/authkit/magic-auth) object with the `code` omitted.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -578,9 +716,57 @@ Events emitted when WorkOS organizations are created, updated, or deleted.
 
 ## Organization domain events {{ "url": "organization-domain" }}
 
-Events emitted when verification status of an organization domain changes.
+Events emitted when organization domains are created, updated, deleted, or their verification status changes.
 
 <Event.Root mt="5">
+  <Event.Details name="organization_domain.created">
+    <CodeBlock
+      title="Organization domain created event"
+      file="event-organization-domain-created"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Organization
+      Domain](/reference/domain-verification) object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization domain is created.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="organization_domain.updated">
+    <CodeBlock
+      title="Organization domain updated event"
+      file="event-organization-domain-updated"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Organization
+      Domain](/reference/domain-verification) object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization domain is updated.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="organization_domain.deleted">
+    <CodeBlock
+      title="Organization domain deleted event"
+      file="event-organization-domain-deleted"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the [Organization
+      Domain](/reference/domain-verification) object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization domain is deleted.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
   <Event.Details name="organization_domain.verified">
     <CodeBlock
       title="Organization domain verified event"
@@ -615,7 +801,7 @@ Events emitted when verification status of an organization domain changes.
 
 ## Organization membership events {{ "url": "organization-membership" }}
 
-Events emitted when a [User Management user](/reference/user-management/user) joins or leaves an organization.
+Events emitted when an [AuthKit user](/reference/authkit/user) joins or leaves an organization.
 
 <Event.Root>
   <Event.Details name="organization_membership.created">
@@ -625,7 +811,7 @@ Events emitted when a [User Management user](/reference/user-management/user) jo
     />
     <Event.Description>
       Payload `data` corresponds to the [Organization
-      Membership](/reference/user-management/organization-membership) object.
+      Membership](/reference/authkit/organization-membership) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -641,7 +827,7 @@ Events emitted when a [User Management user](/reference/user-management/user) jo
     />
     <Event.Description>
       Payload `data` corresponds to the [Organization
-      Membership](/reference/user-management/organization-membership) object.
+      Membership](/reference/authkit/organization-membership) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -657,7 +843,7 @@ Events emitted when a [User Management user](/reference/user-management/user) jo
     />
     <Event.Description>
       Payload `data` corresponds to the [Organization
-      Membership](/reference/user-management/organization-membership) object.
+      Membership](/reference/authkit/organization-membership) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -665,6 +851,55 @@ Events emitted when a [User Management user](/reference/user-management/user) jo
   </Event.Description>
 </Event.Root>
 
+## Organization role events {{ "url": "organization-role" }}
+
+Events emitted when [organization roles](/reference/roles/organization-role) are created, updated, or deleted.
+
+<Event.Root>
+  <Event.Details name="organization_role.created">
+    <CodeBlock
+      title="Organization role created event"
+      file="event-organization-role-created"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the organization role object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization role is created.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="organization_role.deleted">
+    <CodeBlock
+      title="Organization role deleted event"
+      file="event-organization-role-deleted"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the organization role object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization role is deleted.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="organization_role.updated">
+    <CodeBlock
+      title="Organization role updated event"
+      file="event-organization-role-updated"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the organization role object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>
+    Triggered when an organization role is updated.
+  </Event.Description>
+</Event.Root>
+
 ## Password reset events {{ "url": "password-reset" }}
 
 Events emitted when a user requests to reset their password.
@@ -677,8 +912,8 @@ Events emitted when a user requests to reset their password.
     />
     <Event.Description>
       Payload `data` corresponds to the [Organization
-      Membership](/reference/user-management/password-reset) object with the
-      `token` omitted.
+      Membership](/reference/authkit/password-reset) object with the `token`
+      omitted.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -694,8 +929,7 @@ Events emitted when a user requests to reset their password.
     />
     <Event.Description>
       Payload `data` corresponds to the [Password
-      Reset](/reference/user-management/password-reset) object with the `token`
-      omitted.
+      Reset](/reference/authkit/password-reset) object with the `token` omitted.
     </Event.Description>
   </Event.Details>
   <Event.Description>
@@ -703,9 +937,52 @@ Events emitted when a user requests to reset their password.
   </Event.Description>
 </Event.Root>
 
+## Permission events {{ "url": "permission" }}
+
+Events emitted when [permissions](/reference/roles/permission) are created, updated, or deleted.
+
+<Event.Root>
+  <Event.Details name="permission.created">
+    <CodeBlock
+      title="Permission created event"
+      file="event-permission-created"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the permission object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>Triggered when a permission is created.</Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="permission.deleted">
+    <CodeBlock
+      title="Permission deleted event"
+      file="event-permission-deleted"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the permission object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>Triggered when a permission is deleted.</Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="permission.updated">
+    <CodeBlock
+      title="Permission updated event"
+      file="event-permission-updated"
+    />
+    <Event.Description>
+      Payload `data` corresponds to the permission object.
+    </Event.Description>
+  </Event.Details>
+  <Event.Description>Triggered when a permission is updated.</Event.Description>
+</Event.Root>
+
 ## Role events {{ "url": "role" }}
 
-Events emitted when roles are created or deleted in the WorkOS dashboard.
+Events emitted when [environment roles](/reference/roles/role) are created, updated, or deleted.
 
 <Event.Root>
   <Event.Details name="role.created">
@@ -732,7 +1009,7 @@ Events emitted when roles are created or deleted in the WorkOS dashboard.
 
 ## Session events {{ "url": "session" }}
 
-Events emitted when User Management sessions are created.
+Events emitted when AuthKit sessions are created.
 
 <Event.Root>
   <Event.Details name="session.created">
@@ -740,21 +1017,29 @@ Events emitted when User Management sessions are created.
   </Event.Details>
   <Event.Description>
     Triggered when a session is created. Sessions started using
-    [impersonation](/user-management/impersonation) will include an additional
+    [impersonation](/authkit/impersonation) will include an additional
     `impersonator` field with data about the impersonator.
   </Event.Description>
 </Event.Root>
 
+<Event.Root>
+  <Event.Details name="session.revoked">
+    <CodeBlock title="Session revoked event" file="event-session-revoked" />
+  </Event.Details>
+  <Event.Description>
+    Triggered when an issued session is revoked for a user.
+  </Event.Description>
+</Event.Root>
+
 ## User events {{ "url": "user" }}
 
-Events emitted when [User Management users](/reference/user-management/user) are created, updated, or deleted.
+Events emitted when [AuthKit users](/reference/authkit/user) are created, updated, or deleted.
 
 <Event.Root>
   <Event.Details name="user.created">
     <CodeBlock title="User created event" file="event-user-created" />
     <Event.Description>
-      Payload `data` corresponds to the [User](/reference/user-management/user)
-      object.
+      Payload `data` corresponds to the [User](/reference/authkit/user) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>Triggered when a user is created.</Event.Description>
@@ -764,8 +1049,7 @@ Events emitted when [User Management users](/reference/user-management/user) are
   <Event.Details name="user.deleted">
     <CodeBlock title="User deleted event" file="event-user-deleted" />
     <Event.Description>
-      Payload `data` corresponds to the [User](/reference/user-management/user)
-      object.
+      Payload `data` corresponds to the [User](/reference/authkit/user) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>Triggered when a user is deleted.</Event.Description>
@@ -775,9 +1059,111 @@ Events emitted when [User Management users](/reference/user-management/user) are
   <Event.Details name="user.updated">
     <CodeBlock title="User updated event" file="event-user-updated" />
     <Event.Description>
-      Payload `data` corresponds to the [User](/reference/user-management/user)
-      object.
+      Payload `data` corresponds to the [User](/reference/authkit/user) object.
     </Event.Description>
   </Event.Details>
   <Event.Description>Triggered when a user is updated.</Event.Description>
 </Event.Root>
+
+## Vault events {{ "url": "vault" }}
+
+Events emitted when [Vault](/vault) data, keys, or metadata are accessed or modified. Each event payload includes an `actor_id`, `actor_source`, and `actor_name` identifying who performed the action.
+
+<Event.Root mt="5">
+  <Event.Details name="vault.data.created">
+    <CodeBlock
+      title="Vault data created event"
+      file="event-vault-data-created"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when a new encrypted object is stored in Vault.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.data.deleted">
+    <CodeBlock
+      title="Vault data deleted event"
+      file="event-vault-data-deleted"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when an encrypted object is deleted from Vault.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.data.read">
+    <CodeBlock title="Vault data read event" file="event-vault-data-read" />
+  </Event.Details>
+  <Event.Description>
+    Triggered when an encrypted object is read from Vault.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.data.updated">
+    <CodeBlock
+      title="Vault data updated event"
+      file="event-vault-data-updated"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when an existing encrypted object is updated in Vault.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.dek.decrypted">
+    <CodeBlock
+      title="Vault DEK decrypted event"
+      file="event-vault-dek-decrypted"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when a data encryption key (DEK) is decrypted.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.dek.read">
+    <CodeBlock title="Vault DEK read event" file="event-vault-dek-read" />
+  </Event.Details>
+  <Event.Description>
+    Triggered when one or more data encryption keys (DEKs) are read.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.kek.created">
+    <CodeBlock title="Vault KEK created event" file="event-vault-kek-created" />
+  </Event.Details>
+  <Event.Description>
+    Triggered when a new key encryption key (KEK) is created.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.metadata.read">
+    <CodeBlock
+      title="Vault metadata read event"
+      file="event-vault-metadata-read"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when metadata for a Vault store is read.
+  </Event.Description>
+</Event.Root>
+
+<Event.Root>
+  <Event.Details name="vault.names.listed">
+    <CodeBlock
+      title="Vault names listed event"
+      file="event-vault-names-listed"
+    />
+  </Event.Details>
+  <Event.Description>
+    Triggered when the list of Vault store names is retrieved.
+  </Event.Description>
+</Event.Root>

package/.docs/organized/docs/feature-flags/_navigation.mdx

@@ -0,0 +1,10 @@
+---
+title: Feature Flags
+links:
+  - title: Quick Start
+    url: /feature-flags
+  - title: Slack Notifications
+    url: /feature-flags/slack-notifications
+originalPath: .tmp-workos-clone/packages/docs/content/feature-flags/_navigation.mdx
+---
+