@workos/mcp-docs-server 0.1.0 → 0.2.0

package/.docs/organized/docs/reference/{user-management → authkit}/password-reset/create.mdx

@@ -3,7 +3,7 @@ reference:
   curl:
     - key: create_password_reset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: /user_management/password_reset
       type: POST
       sendsEmail: true
@@ -16,7 +16,7 @@ reference:
   js:
     - key: createPasswordReset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: userManagement.createPasswordReset()
       sendsEmail: true
       parameters:
@@ -32,7 +32,7 @@ reference:
   go:
     - key: CreatePasswordReset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: usermanagement.CreatePasswordReset()
       parameters:
         - (ctx)
@@ -49,7 +49,7 @@ reference:
   php:
     - key: createPasswordReset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: $userManagement->createPasswordReset()
       sendsEmail: true
       parameters:
@@ -61,7 +61,7 @@ reference:
   python:
     - key: create_password_reset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: user_management.create_password_reset()
       sendsEmail: true
       parameters:
@@ -73,7 +73,7 @@ reference:
   ruby:
     - key: create_password_reset
       id: create_password_reset
-      url: /reference/user-management/password-reset/create
+      url: /reference/authkit/password-reset/create
       title: UserManagement.create_password_reset()
       sendsEmail: true
       parameters:
@@ -85,7 +85,7 @@ reference:
   java:
     - key: createPasswordReset
       id: create_password_reset
-      url: /reference/user-management/password_reset/create
+      url: /reference/authkit/password_reset/create
       title: userManagement.createPasswordReset()
       sendsEmail: true
       parameters:
@@ -95,7 +95,7 @@ reference:
       returns:
         - (PasswordReset)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/password-reset/create.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/create.mdx
 ---
 
 ## Create a password reset token

package/.docs/organized/docs/reference/{user-management → authkit}/password-reset/get.mdx

@@ -3,7 +3,7 @@ reference:
   curl:
     - key: get_password_reset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: '/user_management/password_reset/:id'
       type: GET
       parameters:
@@ -13,7 +13,7 @@ reference:
   js:
     - key: getPasswordReset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: userManagement.getPasswordReset()
       parameters:
         - (PasswordReset.id)
@@ -22,7 +22,7 @@ reference:
   go:
     - key: getPasswordReset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: usermanagement.GetPasswordReset()
       parameters:
         - (ctx)
@@ -39,7 +39,7 @@ reference:
   php:
     - key: getPasswordReset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: $userManagement->getPasswordReset()
       parameters:
         - (PasswordReset.id)
@@ -48,7 +48,7 @@ reference:
   python:
     - key: get_password_reset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: user_management.get_password_reset()
       parameters:
         - key: password_reset_id
@@ -59,7 +59,7 @@ reference:
   ruby:
     - key: get_password_reset
       id: get_password_reset
-      url: /reference/user-management/password-reset/get
+      url: /reference/authkit/password-reset/get
       title: UserManagement.get_password_reset()
       parameters:
         - (PasswordReset.id)
@@ -68,14 +68,14 @@ reference:
   java:
     - key: getPasswordReset
       id: get_password_reset
-      url: /reference/user-management/password_reset/get
+      url: /reference/authkit/password_reset/get
       title: userManagement.getPasswordReset()
       parameters:
         - (PasswordReset.id)
       returns:
         - (PasswordReset)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/password-reset/get.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/get.mdx
 ---
 
 ## Get a password reset token

package/.docs/organized/docs/reference/{user-management → authkit}/password-reset/index.mdx

@@ -2,8 +2,8 @@
 descriptions:
   password_reset:
     self: >-
-      The corresponding [password
-      reset](/reference/user-management/password-reset) object.
+      The corresponding [password reset](/reference/authkit/password-reset)
+      object.
     object: Distinguishes the password reset object.
     id: The unique ID of the password reset object.
     user_id: The unique ID of the user.
@@ -14,7 +14,7 @@ descriptions:
     created_at: The timestamp when the password reset token was created.
 reference:
   curl:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: password_reset
       id: password_reset
       title: password_reset
@@ -41,7 +41,7 @@ reference:
           type: string
           description: (password_reset.created_at)
   js:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: interface PasswordReset
@@ -71,7 +71,7 @@ reference:
           type: string
           description: (password_reset.created_at)
   go:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: usermanagement.PasswordReset
@@ -98,7 +98,7 @@ reference:
           type: string
           description: (password_reset.created_at)
   php:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: WorkOS\Resource\PasswordReset
@@ -128,7 +128,7 @@ reference:
           type: string
           description: (password_reset.created_at)
   python:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: PasswordReset
@@ -155,7 +155,7 @@ reference:
           type: str
           description: (password_reset.created_at)
   ruby:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: class PasswordReset
@@ -182,7 +182,7 @@ reference:
           type: String
           description: (password_reset.created_at)
   java:
-    - url: /reference/user-management/password-reset
+    - url: /reference/authkit/password-reset
       key: PasswordReset
       id: password_reset
       title: class PasswordReset
@@ -209,9 +209,7 @@ reference:
           type: String
           description: (password_reset.created_at)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/password-reset/index.mdx
----
-
+  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/index.mdx
 ---
 
 # Password reset

package/.docs/organized/docs/reference/{user-management → authkit}/password-reset/reset-password.mdx

@@ -7,7 +7,7 @@ reference:
   curl:
     - key: reset_password
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: /user_management/password_reset/confirm
       type: POST
       parameters:
@@ -28,7 +28,7 @@ reference:
   js:
     - key: resetPassword
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: userManagement.resetPassword()
       parameters:
         - key: token
@@ -48,7 +48,7 @@ reference:
   go:
     - key: ResetPassword
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: usermanagement.ResetPassword()
       parameters:
         - (ctx)
@@ -74,7 +74,7 @@ reference:
   python:
     - key: reset_password
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: user_management.reset_password()
       parameters:
         - key: token
@@ -88,7 +88,7 @@ reference:
   php:
     - key: resetPassword
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: $userManagement->resetPassword()
       parameters:
         - key: token
@@ -104,7 +104,7 @@ reference:
   ruby:
     - key: reset_password
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: UserManagement.reset_password()
       parameters:
         - key: token
@@ -118,7 +118,7 @@ reference:
   java:
     - key: resetPassword
       id: reset_password
-      url: /reference/user-management/password-reset/reset-password
+      url: /reference/authkit/password-reset/reset-password
       title: userManagement.resetPassword()
       parameters:
         - key: token
@@ -130,7 +130,7 @@ reference:
       returns:
         - (User)
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/password-reset/reset-password.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/reset-password.mdx
 ---
 
 ## Reset the password

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

@@ -0,0 +1,128 @@
+---
+descriptions:
+  session:
+    self: 'The corresponding [session](/reference/authkit/session) object.'
+    object: Distinguishes the session object.
+    id: The unique ID of the session.
+    user_id: The ID of the user this session belongs to.
+    organization_id: The ID of the organization this session is associated with.
+    status: The current status of the session.
+    auth_method: The authentication method used to create this session.
+    ip_address: The IP address from which the session was created.
+    user_agent: The user agent string from the device that created the session.
+    impersonator: >-
+      Information about the impersonator if this session was created via
+      impersonation.
+    expires_at: The timestamp when the session expires.
+    ended_at: The timestamp when the session ended.
+    created_at: The timestamp when the session was created.
+    updated_at: The timestamp when the session was last updated.
+reference:
+  curl:
+    - url: /reference/authkit/session
+      key: session
+      id: session
+      title: session
+      properties:
+        - key: object
+          type: '"session"'
+          description: (session.object)
+        - key: id
+          type: string
+          description: (session.id)
+        - key: user_id
+          type: string
+          description: (session.user_id)
+        - key: organization_id
+          optional: true
+          type: string
+          description: (session.organization_id)
+        - key: status
+          type: string
+          description: (session.status)
+        - key: auth_method
+          type: string
+          description: (session.auth_method)
+        - key: ip_address
+          optional: true
+          type: string
+          description: (session.ip_address)
+        - key: user_agent
+          optional: true
+          type: string
+          description: (session.user_agent)
+        - key: impersonator
+          optional: true
+          type: object
+          description: (session.impersonator)
+        - key: expires_at
+          type: string
+          description: (session.expires_at)
+        - key: ended_at
+          optional: true
+          type: string
+          description: (session.ended_at)
+        - key: created_at
+          type: string
+          description: (session.created_at)
+        - key: updated_at
+          type: string
+          description: (session.updated_at)
+  js:
+    - url: /reference/authkit/session
+      key: Session
+      id: session
+      title: interface Session
+      properties:
+        - key: object
+          type: '"session"'
+          description: (session.object)
+        - key: id
+          type: string
+          description: (session.id)
+        - key: userId
+          type: string
+          description: (session.user_id)
+        - key: organizationId
+          optional: true
+          type: string
+          description: (session.organization_id)
+        - key: status
+          type: string
+          description: (session.status)
+        - key: authMethod
+          type: string
+          description: (session.auth_method)
+        - key: ipAddress
+          optional: true
+          type: string
+          description: (session.ip_address)
+        - key: userAgent
+          optional: true
+          type: string
+          description: (session.user_agent)
+        - key: impersonator
+          optional: true
+          type: object
+          description: (session.impersonator)
+        - key: expiresAt
+          type: string
+          description: (session.expires_at)
+        - key: endedAt
+          optional: true
+          type: string
+          description: (session.ended_at)
+        - key: createdAt
+          type: string
+          description: (session.created_at)
+        - key: updatedAt
+          type: string
+          description: (session.updated_at)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/session/index.mdx
+---
+
+# Session
+
+Represents an authenticated user's connection to your application. A session is created when a user signs in through AuthKit and contains information about the authentication method, device details, and session status.
+
+<CodeBlock title="Session" referenceId="session" file="session" />

package/.docs/organized/docs/reference/authkit/session/list.mdx

@@ -0,0 +1,110 @@
+---
+descriptions:
+  list_sessions:
+    user_id: Sessions belonging to this user will be returned.
+    data: 'Array of [sessions](/reference/authkit/session) ordered by creation time.'
+reference:
+  curl:
+    - key: list_sessions
+      id: list_sessions
+      url: /reference/authkit/session/list
+      title: '/user_management/users/:id/sessions'
+      type: GET
+      parameters:
+        - (limit)
+        - (before)
+        - (after)
+        - (order)
+      returns:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: data
+              type: array
+              description: (list_sessions.data)
+            - key: list_metadata
+              type: object
+              properties:
+                - (before)
+                - (after)
+  js:
+    - key: listSessions
+      patternBefore: userManagement.
+      id: list_sessions
+      url: /reference/authkit/session/list
+      title: userManagement.listSessions()
+      parameters:
+        - key: userId
+          type: string
+          description: (list_sessions.user_id)
+        - key: options
+          type: object
+          optional: true
+          unwrap: true
+          properties:
+            - (limit)
+            - (before)
+            - (after)
+            - (order)
+      returns:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: data
+              type: 'Session[]'
+              description: (list_sessions.data)
+            - key: listMetadata
+              type: object
+              properties:
+                - (before)
+                - (after)
+  python:
+    - key: list_sessions
+      patternBefore: user_management
+      id: list_sessions
+      url: /reference/authkit/session/list
+      title: user_management.list_sessions()
+      parameters:
+        - key: user_id
+          type: string
+          description: (list_sessions.user_id)
+        - (limit)
+        - (before)
+        - (after)
+        - (order)
+      returns:
+        - key: anonymous
+          type: WorkOSListResource
+          unwrap: true
+          properties:
+            - key: data
+              type: 'list[Session]'
+              description: (list_sessions.data)
+            - key: list_metadata
+              type: 'list[ListMetadata]'
+              properties:
+                - (before)
+                - (after)
+            - key: list_args
+              type: SessionsListFilters
+              properties:
+                - key: user_id
+                  type: string
+                  description: (list_sessions.user_id)
+                - (before)
+                - (after)
+                - (limit)
+                - (order)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/session/list.mdx
+---
+
+## List sessions
+
+Get a list of all active sessions for a specific user.
+
+<CodeBlock referenceId="list_sessions">
+  <CodeBlockTab title="Request" file="list-sessions-request" />
+  <CodeBlockTab title="Response" file="list-sessions-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/authkit/session/revoke.mdx

@@ -0,0 +1,73 @@
+---
+reference:
+  curl:
+    - key: revoke_session
+      id: revoke_session
+      url: /reference/authkit/session/revoke
+      title: /user_management/sessions/revoke
+      type: POST
+      parameters:
+        - key: session_id
+          type: string
+          description: (session.id)
+  js:
+    - key: revokeSession
+      patternBefore: userManagement.
+      id: revoke_session
+      url: /reference/authkit/session/revoke
+      title: userManagement.revokeSession()
+      parameters:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: sessionId
+              type: string
+              description: (session.id)
+  python:
+    - key: revoke_session
+      patternBefore: user_management
+      id: revoke_session
+      url: /reference/authkit/session/revoke
+      title: user_management.revoke_session()
+      parameters:
+        - key: session_id
+          type: string
+          description: (session.id)
+  ruby:
+    - key: revoke_session
+      patternBefore: UserManagement.
+      id: revoke_session
+      url: /reference/authkit/session/revoke
+      title: UserManagement.revoke_session()
+      parameters:
+        - key: session_id
+          type: String
+          description: (session.id)
+  go:
+    - key: RevokeSession
+      patternBefore: usermanagement
+      id: revoke_session
+      url: /reference/authkit/session/revoke
+      title: usermanagement.RevokeSession()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: usermanagement.RevokeSessionOpts
+          unwrap: true
+          properties:
+            - key: SessionID
+              type: string
+              description: (session.id)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/authkit/session/revoke.mdx
+---
+
+## Revoke session
+
+Revoke a session.
+
+<CodeBlock
+  referenceId="revoke_session"
+  title="Request"
+  file="revoke-session-request"
+/>

package/.docs/organized/docs/reference/{user-management → authkit}/session-helpers/authenticate.mdx

@@ -3,7 +3,7 @@ reference:
   js:
     - key: authenticate
       id: authenticate
-      url: /reference/user-management/session-helpers
+      url: /reference/authkit/session-helpers
       title: session.authenticate()
       returns:
         - key: anonymous
@@ -29,7 +29,11 @@ reference:
             - key: role
               type: string
               optional: true
-              description: The role of the user.
+              description: (access_token.role)
+            - key: roles
+              type: array
+              optional: true
+              description: (access_token.roles)
             - key: permissions
               optional: true
               type: array
@@ -38,6 +42,10 @@ reference:
               optional: true
               type: array
               description: The entitlements of the user.
+            - key: featureFlags
+              optional: true
+              type: array
+              description: The feature flags of the user.
             - key: impersonator
               type: object
               optional: true
@@ -60,7 +68,7 @@ reference:
   ruby:
     - key: authenticate
       id: authenticate
-      url: /reference/user-management/session-helpers
+      url: /reference/authkit/session-helpers
       title: session.authenticate()
       returns:
         - key: anonymous
@@ -88,6 +96,10 @@ reference:
               optional: true
               type: array
               description: The permissions of the user.
+            - key: feature_flags
+              optional: true
+              type: array
+              description: The feature flags of the user.
             - key: impersonator
               type: object
               optional: true
@@ -110,7 +122,7 @@ reference:
   python:
     - key: authenticate
       id: authenticate
-      url: /reference/user-management/session-helpers
+      url: /reference/authkit/session-helpers
       title: session.authenticate()
       returns:
         - key: anonymous
@@ -133,7 +145,11 @@ reference:
             - key: role
               type: string
               optional: true
-              description: The role of the user.
+              description: (access_token.role)
+            - key: roles
+              type: array
+              optional: true
+              description: (access_token.roles)
             - key: permissions
               optional: true
               type: array
@@ -162,7 +178,7 @@ reference:
                 The reason authentication failed. Only present if `authenticated
                 = false`.
 originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/user-management/session-helpers/authenticate.mdx
+  .tmp-workos-clone/packages/docs/content/reference/authkit/session-helpers/authenticate.mdx
 ---
 
 ## Authenticate