@workos/mcp-docs-server 0.1.0 → 0.2.0

package/.docs/organized/docs/reference/{user-management → authkit}/mfa/authentication-challenge.mdx

@@ -3,8 +3,7 @@ descriptions:
   user_management_authentication_challenge:
     self: >-
       The [authentication
-      challenge](/reference/user-management/mfa/authentication-challenge)
-      object.
+      challenge](/reference/authkit/mfa/authentication-challenge) object.
     object: Distinguishes the authentication challenge object.
     id: The unique ID of the authentication challenge.
     created_at: The timestamp when the challenge was created.
@@ -15,7 +14,7 @@ descriptions:
     authentication_factor_id: The unique ID of the authentication factor the challenge belongs to.
 reference:
   curl:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: authentication_challenge
       id: authentication_challenge
       title: authentication_challenge
@@ -39,7 +38,7 @@ reference:
           type: string
           description: (user_management_authentication_challenge.authentication_factor_id)
   go:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: Challenge
       id: authentication_challenge
       title: mfa.Challenge
@@ -63,7 +62,7 @@ reference:
           type: string
           description: (user_management_authentication_challenge.authentication_factor_id)
   ruby:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: Challenge
       id: authentication_challenge
       title: class Challenge
@@ -87,7 +86,7 @@ reference:
           type: String
           description: (user_management_authentication_challenge.authentication_factor_id)
   python:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: AuthenticationChallenge
       id: authentication_challenge
       title: AuthenticationChallenge
@@ -111,7 +110,7 @@ reference:
           type: str
           description: (user_management_authentication_challenge.authentication_factor_id)
   js:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: Challenge
       id: authentication_challenge
       title: interface Challenge
@@ -135,7 +134,7 @@ reference:
           type: string
           description: (user_management_authentication_challenge.authentication_factor_id)
   php:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: AuthenticationChallenge
       id: authentication_challenge
       title: WorkOS\Resource\AuthenticationChallenge
@@ -159,7 +158,7 @@ reference:
           type: string
           description: (user_management_authentication_challenge.authentication_factor_id)
   java:
-    - url: /reference/user-management/mfa/authentication-challenge
+    - url: /reference/authkit/mfa/authentication-challenge
       key: AuthenticationChallenge
       id: authentication_challenge
       title: class AuthenticationChallenge
@@ -180,7 +179,7 @@ reference:
           type: String
           description: (user_management_authentication_challenge.authentication_factor_id)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/mfa/authentication-challenge.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/mfa/authentication-challenge.mdx
 ---
 
 ## Authentication challenge

package/.docs/organized/docs/reference/{user-management → authkit}/mfa/authentication-factor.mdx

@@ -2,8 +2,8 @@
 descriptions:
   user_management_authentication_factor:
     self: >-
-      The [authentication
-      factor](/reference/user-management/mfa/authentication-factor) object.
+      The [authentication factor](/reference/authkit/mfa/authentication-factor)
+      object.
     object: Distinguishes the authentication factor object.
     id: The unique ID of the factor.
     created_at: The timestamp when the factor was created.
@@ -21,10 +21,10 @@ descriptions:
       TOTP secret that can be manually entered into some authenticator apps in
       place of scanning a QR code.
     totp_uri: The `otpauth` URI that is encoded by the provided `qr_code`.
-    user_id: 'The ID of the [user](/reference/user-management/user).'
+    user_id: 'The ID of the [user](/reference/authkit/user).'
 reference:
   curl:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: authentication_factor
       id: authentication_factor
       title: authentication_factor
@@ -67,7 +67,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
   go:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: Factor
       id: authentication_factor
       title: mfa.Factor
@@ -98,7 +98,7 @@ reference:
               type: string
               description: (user_management_authentication_factor.totp_uri)
   ruby:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: Factor
       id: authentication_factor
       title: class Factor
@@ -141,7 +141,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
   python:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: user_management_authentication_factor
       id: user_management_authentication_factor
       title: AuthenticationFactorTotp
@@ -184,7 +184,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
   js:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: Factor
       id: authentication_factor
       title: interface Factor
@@ -227,7 +227,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
   php:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: AuthenticationFactor
       id: authentication_factor
       title: WorkOS\Resource\AuthenticationFactor
@@ -270,7 +270,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
   java:
-    - url: /reference/user-management/mfa/authentication-factor
+    - url: /reference/authkit/mfa/authentication-factor
       key: AuthenticationFactor
       id: authentication_factor
       title: class AuthenticationFactor
@@ -310,7 +310,7 @@ reference:
           type: string
           description: (user_management_authentication_factor.user_id)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/mfa/authentication-factor.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/mfa/authentication-factor.mdx
 ---
 
 ## Authentication factor

package/.docs/organized/docs/reference/{user-management → authkit}/mfa/enroll-auth-factor.mdx

@@ -9,21 +9,25 @@ descriptions:
     totp_user: >-
       The user’s account name displayed in their authenticator app. Defaults to
       the user’s email.
-    totp_secret: "The Base32-encoded shared secret for TOTP factors. This can be provided when creating the auth factor, otherwise it will be generated. The algorithm used to derive TOTP codes is sha1, the code length is 6 digits, and the timestep is 30 seconds –\_the secret must be compatible with these parameters."
+    totp_secret: >-
+      The Base32-encoded shared secret for TOTP factors. This can be provided
+      when creating the auth factor, otherwise it will be generated. The
+      algorithm used to derive TOTP codes is sha1, the code length is 6 digits,
+      and the timestep is 30 seconds – the secret must be compatible with these
+      parameters.
     factor: >-
-      The [authentication
-      factor](/reference/user-management/mfa/authentication-factor) object that
-      represents the additional authentication method used on top of the
-      existing authentication strategy.
+      The [authentication factor](/reference/authkit/mfa/authentication-factor)
+      object that represents the additional authentication method used on top of
+      the existing authentication strategy.
     challenge: >-
       The [authentication
-      challenge](/reference/user-management/mfa/authentication-challenge) object
-      that is used to complete the authentication process.
+      challenge](/reference/authkit/mfa/authentication-challenge) object that is
+      used to complete the authentication process.
 reference:
   curl:
     - key: enroll_auth_factor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: '/user_management/users/:id/auth_factors'
       type: POST
       parameters:
@@ -59,7 +63,7 @@ reference:
   js:
     - key: enrollAuthFactor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: userManagement.enrollAuthFactor()
       parameters:
         - key: options
@@ -98,7 +102,7 @@ reference:
   python:
     - key: enroll_auth_factor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: user_management.enroll_auth_factor()
       parameters:
         - key: user_id
@@ -133,7 +137,7 @@ reference:
   go:
     - key: EnrollAuthFactor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: usermanagement.EnrollAuthFactor()
       parameters:
         - (ctx)
@@ -174,7 +178,7 @@ reference:
   php:
     - key: enrollAuthFactor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: $userManagement->enrollAuthFactor()
       parameters:
         - key: id
@@ -209,7 +213,7 @@ reference:
   ruby:
     - key: enroll_auth_factor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: UserManagement.enroll_auth_factor()
       parameters:
         - key: user_id
@@ -244,7 +248,7 @@ reference:
   java:
     - key: enrollAuthFactor
       id: enroll_auth_factor
-      url: /reference/user-management/mfa/enroll-auth-factor
+      url: /reference/authkit/mfa/enroll-auth-factor
       title: userManagement.enrollAuthFactor()
       parameters:
         - key: id
@@ -282,7 +286,7 @@ reference:
               type: AuthenticationFactor
               description: (enroll_auth_factor.factor)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/mfa/enroll-auth-factor.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/mfa/enroll-auth-factor.mdx
 ---
 
 ## Enroll an authentication factor

package/.docs/organized/docs/reference/authkit/mfa/index.mdx

@@ -0,0 +1,11 @@
+---
+title: Multi-Factor Authentication
+description: >-
+  Enroll users in multi-factor authentication for an additional layer of
+  security.
+originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/mfa/index.mdx
+---
+
+# Multi-Factor Authentication
+
+Enroll users in multi-factor authentication for an additional layer of security. MFA can be enabled via the [Authentication page](https://dashboard.workos.com/authentication) in the WorkOS dashboard.

package/.docs/organized/docs/reference/{user-management → authkit}/mfa/list-auth-factors.mdx

@@ -4,12 +4,12 @@ descriptions:
     user_id: The user ID to list the authentication factors for.
     data: >-
       List of [authentication
-      factors](/reference/user-management/mfa/authentication-factor).
+      factors](/reference/authkit/mfa/authentication-factor).
 reference:
   curl:
     - key: list_auth_factors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: '/user_management/users/:id/auth_factors'
       type: GET
       parameters:
@@ -32,7 +32,7 @@ reference:
   js:
     - key: listAuthFactors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: userManagement.listAuthFactors()
       parameters:
         - key: userId
@@ -59,7 +59,7 @@ reference:
     - key: ListAuthFactors
       patternBefore: usermanagement.
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: usermanagement.ListAuthFactors()
       parameters:
         - (ctx)
@@ -91,7 +91,7 @@ reference:
   python:
     - key: list_auth_factors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: user_management.list_auth_factors()
       parameters:
         - key: user_id
@@ -117,7 +117,7 @@ reference:
   php:
     - key: listAuthFactors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: $userManagement->listAuthFactors()
       parameters:
         - key: userId
@@ -134,7 +134,7 @@ reference:
   ruby:
     - key: list_auth_factors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: UserManagement.list_auth_factors()
       parameters:
         - key: user_id
@@ -160,7 +160,7 @@ reference:
   java:
     - key: listAuthFactors
       id: list_auth_factors
-      url: /reference/user-management/mfa/list-auth-factors
+      url: /reference/authkit/mfa/list-auth-factors
       title: userManagement.listAuthFactors()
       parameters:
         - key: id
@@ -180,7 +180,7 @@ reference:
                 - (before)
                 - (after)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/mfa/list-auth-factors.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/mfa/list-auth-factors.mdx
 ---
 
 ## List authentication factors

package/.docs/organized/docs/reference/{user-management → authkit}/organization-membership/create.mdx

@@ -1,12 +1,17 @@
 ---
 descriptions:
   create_organization_membership:
-    role_slug: The unique role identifier. Defaults to `member`.
+    role_slug: >-
+      A single role identifier. Defaults to `member` or the explicit default
+      role. Mutually exclusive with `role_slugs`.
+    role_slugs: >-
+      An array of role identifiers. Mutually exclusive with `role_slug`. Limited
+      to one role when Multiple Roles is disabled.
 reference:
   curl:
     - key: create_organization_membership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: /user_management/organization_memberships
       type: POST
       parameters:
@@ -20,12 +25,16 @@ reference:
           type: string
           description: (create_organization_membership.role_slug)
           optional: true
+        - key: role_slugs
+          type: array
+          description: (create_organization_membership.role_slugs)
+          optional: true
       returns:
         - (organization_membership)
   js:
     - key: createOrganizationMembership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: userManagement.createOrganizationMembership()
       parameters:
         - key: options
@@ -38,12 +47,16 @@ reference:
               type: string
               optional: true
               description: (create_organization_membership.role_slug)
+            - key: roleSlugs
+              type: array
+              optional: true
+              description: (create_organization_membership.role_slugs)
       returns:
         - (OrganizationMembership)
   go:
     - key: CreateOrganizationMembership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: usermanagement.CreateOrganizationMembership()
       parameters:
         - (ctx)
@@ -69,7 +82,7 @@ reference:
   php:
     - key: createOrganizationMembership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: $userManagement->createOrganizationMembership()
       parameters:
         - key: userId
@@ -85,7 +98,7 @@ reference:
   python:
     - key: create_organization_membership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: user_management.create_organization_membership()
       parameters:
         - key: user_id
@@ -98,12 +111,16 @@ reference:
           type: str
           optional: true
           description: (create_organization_membership.role_slug)
+        - key: role_slugs
+          type: 'List[str]'
+          optional: true
+          description: (create_organization_membership.role_slugs)
       returns:
         - (OrganizationMembership)
   ruby:
     - key: create_organization_membership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: UserManagement.create_organization_membership()
       parameters:
         - (OrganizationMembership.user_id)
@@ -117,7 +134,7 @@ reference:
   java:
     - key: createOrganizationMembership
       id: create_organization_membership
-      url: /reference/user-management/organization-membership/create
+      url: /reference/authkit/organization-membership/create
       title: userManagement.createOrganizationMembership()
       parameters:
         - key: options
@@ -137,14 +154,14 @@ reference:
       returns:
         - (OrganizationMembership)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/organization-membership/create.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/organization-membership/create.mdx
 ---
 
 ## Create an organization membership
 
 Creates a new `active` organization membership for the given organization and user.
 
-Calling this API with an organization and user that match an `inactive` organization membership will activate the membership with the specified role.
+Calling this API with an organization and user that match an `inactive` organization membership will activate the membership with the specified role(s).
 
 <CodeBlock referenceId="create_organization_membership">
   <CodeBlockTab title="Request" file="create-organization-membership-request" />

package/.docs/organized/docs/reference/{user-management → authkit}/organization-membership/deactivate.mdx

@@ -3,7 +3,7 @@ reference:
   curl:
     - key: deactivate_organization_membership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: '/user_management/organization_memberships/:id/deactivate'
       type: PUT
       parameters:
@@ -13,7 +13,7 @@ reference:
   js:
     - key: deactivateOrganizationMembership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: userManagement.deactivateOrganizationMembership()
       parameters:
         - key: options
@@ -27,7 +27,7 @@ reference:
     - key: deactivateOrganizationMembership
       patternBefore: usermanagement.
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: usermanagement.deactivateOrganizationMembership()
       parameters:
         - (ctx)
@@ -46,7 +46,7 @@ reference:
   php:
     - key: deactivateOrganizationMembership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: $userManagement->deactivateOrganizationMembership()
       parameters:
         - (OrganizationMembership.id)
@@ -55,7 +55,7 @@ reference:
   python:
     - key: deactivate_organization_membership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: user_management.deactivate_organization_membership()
       parameters:
         - key: organization_membership_id
@@ -66,7 +66,7 @@ reference:
   ruby:
     - key: deactivate_organization_membership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: UserManagement.deactivate_organization_membership()
       parameters:
         - (OrganizationMembership.id)
@@ -75,14 +75,14 @@ reference:
   java:
     - key: deactivateOrganizationMembership
       id: deactivate_organization_membership
-      url: /reference/user-management/organization-membership/deactivate
+      url: /reference/authkit/organization-membership/deactivate
       title: userManagement.deactivateOrganizationMembership()
       parameters:
         - (OrganizationMembership.id)
       returns:
         - (OrganizationMembership)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/organization-membership/deactivate.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/organization-membership/deactivate.mdx
 ---
 
 ## Deactivate an organization membership
@@ -90,9 +90,9 @@ originalPath: >-
 Deactivates an `active` organization membership. Emits an [organization_membership.updated](/events/organization-membership) event upon successful deactivation.
 
 - Deactivating an `inactive` membership is a no-op and does not emit an event.
-- Deactivating a `pending` membership returns an error. This membership should be [deleted](/reference/user-management/organization-membership/delete) instead.
+- Deactivating a `pending` membership returns an error. This membership should be [deleted](/reference/authkit/organization-membership/delete) instead.
 
-See the [membership management documentation](/user-management/users-organizations/organizations/membership-management) for additional details.
+See the [membership management documentation](/authkit/users-organizations/organizations/membership-management) for additional details.
 
 <CodeBlock referenceId="deactivate_organization_membership">
   <CodeBlockTab

package/.docs/organized/docs/reference/{user-management → authkit}/organization-membership/delete.mdx

@@ -3,7 +3,7 @@ reference:
   curl:
     - key: delete_organization_membership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: '/user_management/organization_memberships/:id'
       type: DELETE
       parameters:
@@ -11,14 +11,14 @@ reference:
   js:
     - key: deleteOrganizationMembership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: userManagement.deleteOrganizationMembership()
       parameters:
         - (OrganizationMembership.id)
   go:
     - key: DeleteOrganizationMembership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: usermanagement.DeleteOrganizationMembership()
       parameters:
         - (ctx)
@@ -34,14 +34,14 @@ reference:
   php:
     - key: deleteOrganizationMembership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: $userManagement->deleteOrganizationMembership()
       parameters:
         - (OrganizationMembership.id)
   python:
     - key: delete_organization_membership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: user_management.delete_organization_membership()
       parameters:
         - key: organization_membership_id
@@ -50,19 +50,19 @@ reference:
   ruby:
     - key: delete_organization_membership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: UserManagement.delete_organization_membership()
       parameters:
         - (OrganizationMembership.id)
   java:
     - key: deleteOrganizationMembership
       id: delete_organization_membership
-      url: /reference/user-management/organization-membership/delete
+      url: /reference/authkit/organization-membership/delete
       title: userManagement.deleteOrganizationMembership()
       parameters:
         - (OrganizationMembership.id)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/organization-membership/delete.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/organization-membership/delete.mdx
 ---
 
 ## Delete an organization membership