@workos/mcp-docs-server 0.1.0

package/.docs/organized/docs/reference/user-management/session-tokens/jwks.mdx

@@ -0,0 +1,110 @@
+---
+descriptions:
+  get_jwks_url:
+    url: URL that hosts the JWKS for signing access tokens.
+reference:
+  curl:
+    - key: getJwksUrl
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: /sso/jwks
+      type: GET
+      properties:
+        - key: clientId
+          type: string
+          description: (client_id)
+      returns:
+        - key: url
+          type: string
+          description: (get_jwks_url.url)
+  js:
+    - key: getJwksUrl
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: userManagement.getJwksUrl()
+      parameters:
+        - key: clientId
+          type: string
+          description: (client_id)
+      returns:
+        - key: jwksUrl
+          type: string
+          description: (get_jwks_url.url)
+  go:
+    - key: GetJwksUrl
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: usermanagement.GetJwksUrl()
+      parameters:
+        - key: ClientID
+          type: string
+          description: (client_id)
+      returns:
+        - key: jwksUrl
+          type: string
+          description: (get_jwks_url.url)
+        - (err)
+  ruby:
+    - key: get_jwks_url
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: UserManagement.get_jwks_url()
+      parameters:
+        - key: client_id
+          type: String
+          description: (client_id)
+      returns:
+        - key: jwksUrl
+          type: string
+          description: (get_jwks_url.url)
+  java:
+    - key: getJwksUrl
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: userManagement.getJwksUrl()
+      parameters:
+        - key: clientId
+          type: String
+          description: (client_id)
+      returns:
+        - key: jwksUrl
+          type: String
+          description: (get_jwks_url.url)
+  php:
+    - key: getJwksUrl
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: $userManagement->getJwksUrl()
+      parameters:
+        - key: clientId
+          type: String
+          description: (client_id)
+      returns:
+        - key: jwksUrl
+          type: string
+          description: (get_jwks_url.url)
+  python:
+    - key: get_jwks_url
+      id: get_jwks_url
+      url: /reference/user-management/session-tokens/jwks
+      title: user_management.get_jwks_url()
+      parameters:
+        - key: client_id
+          type: String
+          description: (client_id)
+      returns:
+        - key: jwks_url
+          type: string
+          description: (get_jwks_url.url)
+originalPath: >-
+  .tmp-workos-clone/packages/docs/content/reference/user-management/session-tokens/jwks.mdx
+---
+
+## JWKS URL
+
+This hosts the public key that is used for verifying access tokens.
+
+<CodeBlock referenceId="get_jwks_url">
+  <CodeBlockTab title="Request" file="get-jwks-url-request" />
+  <CodeBlockTab title="Response" file="get-jwks-url-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/user-management/session-tokens/refresh-token.mdx

@@ -0,0 +1,8 @@
+---
+originalPath: >-
+  .tmp-workos-clone/packages/docs/content/reference/user-management/session-tokens/refresh-token.mdx
+---
+## Refresh token
+
+The refresh token can be used to obtain a new access token using the [authenticate with refresh token
+](reference/user-management/authentication/refresh-token) endpoint. Refresh tokens may only be used once. Refreshes will succeed as long as the user's session is still active.

package/.docs/organized/docs/reference/user-management/user/create.mdx

@@ -0,0 +1,327 @@
+---
+descriptions:
+  create_user:
+    password: The password to set for the user.
+    password_hash: >-
+      The hashed password to set for the user. Mutually exclusive with
+      `password`.
+    password_hash_type: >
+      The algorithm originally used to hash the password, used when providing a
+      `password_hash`. Valid values are `bcrypt`, `scrypt`, `firebase-scrypt`,
+      `ssha`, and `pbkdf2`.
+
+
+      See the [Firebase Migration guide](/migrate/firebase) for an example of
+      how to format the `password_hash` when importing `firebase-scrypt`
+      passwords.
+    email_verified: >
+      Whether the user’s email address was previously verified.
+
+
+      You should normally use the [email verification
+      flow](/reference/user-management/authentication/email-verification)
+
+      to verify a user’s email address. However, if the user’s email was
+      previously verified, or
+
+      is being migrated from an existing user store, this can be set to `true`
+      to mark it as
+
+      already verified.
+    external_id: >-
+      The [external identifier](/user-management/metadata/external-identifiers)
+      of the user.
+    metadata: >-
+      Object containing [metadata](/user-management/metadata) key/value pairs
+      associated with the user.
+reference:
+  curl:
+    - key: create_user
+      id: create_user
+      url: /reference/user-management/user/create
+      title: /user_management/users
+      type: POST
+      parameters:
+        - key: email
+          type: string
+          description: (user.email)
+        - key: password
+          type: string
+          optional: true
+          description: (create_user.password)
+        - key: password_hash
+          type: string
+          optional: true
+          description: (create_user.password_hash)
+        - key: password_hash_type
+          type: string
+          optional: true
+          description: (create_user.password_hash_type)
+        - key: first_name
+          type: string
+          optional: true
+          description: (user.first_name)
+        - key: last_name
+          type: string
+          optional: true
+          description: (user.last_name)
+        - key: email_verified
+          type: boolean
+          optional: true
+          description: (create_user.email_verified)
+        - key: external_id
+          type: string
+          optional: true
+          description: (user.external_id)
+        - key: metadata
+          type: object
+          optional: true
+          description: (user.metadata)
+      returns:
+        - (user)
+  js:
+    - key: createUser
+      id: create_user
+      url: /reference/user-management/user/create
+      title: userManagement.createUser()
+      parameters:
+        - key: options
+          type: object
+          unwrap: true
+          properties:
+            - key: email
+              type: string
+              description: (user.email)
+            - key: password
+              type: string
+              optional: true
+              description: (create_user.password)
+            - key: passwordHash
+              type: string
+              optional: true
+              description: (create_user.password_hash)
+            - key: passwordHashType
+              type: string
+              optional: true
+              description: (create_user.password_hash_type)
+            - key: firstName
+              type: string
+              optional: true
+              description: (user.first_name)
+            - key: lastName
+              type: string
+              optional: true
+              description: (user.last_name)
+            - key: emailVerified
+              type: boolean
+              optional: true
+              description: (create_user.email_verified)
+            - key: externalId
+              type: string
+              optional: true
+              description: (user.external_id)
+            - key: metadata
+              type: object
+              optional: true
+              description: (user.metadata)
+      returns:
+        - (User)
+  go:
+    - key: CreateUser
+      id: create_user
+      url: /reference/user-management/user/create
+      title: usermanagement.CreateUser()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: usermanagement.CreateUserOpts
+          unwrap: true
+          properties:
+            - key: Email
+              type: string
+              description: (user.email)
+            - key: Password
+              type: string
+              optional: true
+              description: (create_user.password)
+            - key: PasswordHash
+              type: string
+              optional: true
+              description: (create_user.password_hash)
+            - key: PasswordHashType
+              type: string
+              optional: true
+              description: (create_user.password_hash_type)
+            - key: FirstName
+              type: string
+              optional: true
+              description: (user.first_name)
+            - key: LastName
+              type: string
+              optional: true
+              description: (user.last_name)
+            - key: EmailVerified
+              type: boolean
+              optional: true
+              description: (create_user.email_verified)
+      returns:
+        - key: user
+          type: usermanagement.User
+          description: (user.self)
+        - (err)
+  php:
+    - key: createUser
+      id: create_user
+      url: /reference/user-management/user/create
+      title: $userManagement->createUser()
+      parameters:
+        - key: email
+          type: string
+          description: (user.email)
+        - key: password
+          type: string
+          optional: true
+          description: (create_user.password)
+        - key: passwordHash
+          type: string
+          optional: true
+          description: (create_user.password_hash)
+        - key: passwordHashType
+          type: string
+          optional: true
+          description: (create_user.password_hash_type)
+        - key: firstName
+          type: string
+          optional: true
+          description: (user.first_name)
+        - key: lastName
+          type: string
+          optional: true
+          description: (user.last_name)
+        - key: emailVerified
+          type: boolean
+          optional: true
+          description: (create_user.email_verified)
+      returns:
+        - (User)
+  python:
+    - key: create_user
+      id: create_user
+      url: /reference/user-management/user/create
+      title: user_management.create_user()
+      parameters:
+        - key: email
+          type: str
+          description: (user.email)
+        - key: password
+          type: str
+          optional: true
+          description: (create_user.password)
+        - key: password_hash
+          type: str
+          optional: true
+          description: (create_user.password_hash)
+        - key: password_hash_type
+          type: PasswordHashType
+          optional: true
+          description: (create_user.password_hash_type)
+        - key: first_name
+          type: str
+          optional: true
+          description: (user.first_name)
+        - key: last_name
+          type: str
+          optional: true
+          description: (user.last_name)
+        - key: email_verified
+          type: bool
+          optional: true
+          description: (create_user.email_verified)
+      returns:
+        - (User)
+  ruby:
+    - key: create_user
+      id: create_user
+      url: /reference/user-management/user/create
+      title: UserManagement.create_user()
+      parameters:
+        - key: email
+          type: String
+          description: (user.email)
+        - key: password
+          type: String
+          optional: true
+          description: (create_user.password)
+        - key: password_hash
+          type: String
+          optional: true
+          description: (create_user.password_hash)
+        - key: password_hash_type
+          type: String
+          optional: true
+          description: (create_user.password_hash_type)
+        - key: first_name
+          type: String
+          optional: true
+          description: (user.first_name)
+        - key: last_name
+          type: String
+          optional: true
+          description: (user.last_name)
+        - key: email_verified
+          type: Boolean
+          optional: true
+          description: (create_user.email_verified)
+      returns:
+        - (User)
+  java:
+    - key: createUser
+      id: create_user
+      url: /reference/user-management/user/create
+      title: userManagement.createUser()
+      parameters:
+        - key: options
+          type: CreateUserOptions
+          unwrap: true
+          properties:
+            - key: email
+              type: String
+              description: (user.email)
+            - key: password
+              type: String
+              optional: true
+              description: (create_user.password)
+            - key: passwordHash
+              type: String
+              optional: true
+              description: (create_user.password_hash)
+            - key: passwordHashType
+              type: PasswordHashTypeEnumType
+              optional: true
+              description: (create_user.password_hash_type)
+            - key: firstName
+              type: String
+              optional: true
+              description: (user.first_name)
+            - key: lastName
+              type: String
+              optional: true
+              description: (user.last_name)
+            - key: emailVerified
+              type: Boolean
+              optional: true
+              description: (create_user.email_verified)
+      returns:
+        - (User)
+originalPath: >-
+  .tmp-workos-clone/packages/docs/content/reference/user-management/user/create.mdx
+---
+
+## Create a user
+
+Create a new user in the current environment.
+
+<CodeBlock title="Request" referenceId="create_user">
+  <CodeBlockTab title="Request" file="create-user-request" />
+  <CodeBlockTab title="Response" file="create-user-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/user-management/user/delete.mdx

@@ -0,0 +1,76 @@
+---
+reference:
+  curl:
+    - key: delete_user
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: '/user_management/users/:id'
+      type: DELETE
+      parameters:
+        - (user.id)
+  js:
+    - key: deleteUser
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: userManagement.deleteUser()
+      parameters:
+        - (User.id)
+  php:
+    - key: deleteUser
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: $userManagement->deleteUser()
+      parameters:
+        - key: id
+          type: string
+          description: (user.id)
+  go:
+    - key: DeleteUser
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: usermanagement.DeleteUser()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: usermanagement.DeleteUserOpts
+          unwrap: true
+          properties:
+            - key: User
+              type: string
+              description: (user.id)
+  python:
+    - key: delete_user
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: user_management.delete_user()
+      parameters:
+        - key: user_id
+          type: string
+          description: (user.id)
+  ruby:
+    - key: delete_user
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: UserManagement.delete_user()
+      parameters:
+        - key: id
+          type: String
+          description: (user.id)
+  java:
+    - key: deleteUser
+      id: delete_user
+      url: /reference/user-management/user/delete
+      title: userManagement.deleteUser()
+      parameters:
+        - key: userId
+          type: String
+          description: (user.id)
+originalPath: >-
+  .tmp-workos-clone/packages/docs/content/reference/user-management/user/delete.mdx
+---
+
+## Delete a user
+
+Permanently deletes a user in the current environment. It cannot be undone.
+
+<CodeBlock title="Request" referenceId="delete_user" file="delete-user" />

package/.docs/organized/docs/reference/user-management/user/get-by-external-id.mdx

@@ -0,0 +1,39 @@
+---
+reference:
+  curl:
+    - key: get_user_by_external_id
+      id: get_user_by_external_id
+      url: /reference/user-management/user/get-by-external-id
+      title: '/user_management/users/external_id/:external_id'
+      type: GET
+      parameters:
+        - key: external_id
+          type: string
+          description: (user.external_id)
+      returns:
+        - (user)
+  js:
+    - key: getUserByExternalId
+      patternBefore: userManagement.
+      id: get_user_by_external_id
+      url: /reference/user-management/user/get-by-external-id
+      title: userManagement.getUserByExternalId()
+      type: GET
+      parameters:
+        - key: externalId
+          type: string
+          description: (user.external_id)
+      returns:
+        - (User)
+originalPath: >-
+  .tmp-workos-clone/packages/docs/content/reference/user-management/user/get-by-external-id.mdx
+---
+
+## Get a user by external ID
+
+Get the details of an existing user by an [external identifier](/user-management/metadata/external-identifiers).
+
+<CodeBlock referenceId="get_user_by_external_id">
+  <CodeBlockTab title="Request" file="get-user-by-external-id-request" />
+  <CodeBlockTab title="Response" file="get-user-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/user-management/user/get.mdx

@@ -0,0 +1,103 @@
+---
+reference:
+  curl:
+    - key: get_user
+      id: get_user
+      url: /reference/user-management/user/get
+      title: '/user_management/users/:id'
+      type: GET
+      parameters:
+        - (user.id)
+      returns:
+        - (user)
+  js:
+    - key: getUser
+      patternBefore: userManagement.
+      id: get_user
+      url: /reference/user-management/user/get
+      title: userManagement.getUser()
+      type: GET
+      parameters:
+        - (User.id)
+      returns:
+        - (User)
+  go:
+    - key: GetUser
+      patternBefore: usermanagement.
+      id: get_user
+      url: /reference/user-management/user/get
+      title: usermanagement.GetUser()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: usermanagement.GetUserOpts
+          unwrap: true
+          properties:
+            - key: User
+              type: string
+              description: (user.id)
+      returns:
+        - key: user
+          type: usermanagement.User
+          description: (user.self)
+        - (err)
+  php:
+    - key: getUser
+      patternBefore: userManagement->
+      id: get_user
+      url: /reference/user-management/user/get
+      title: $userManagement->getUser()
+      type: GET
+      parameters:
+        - key: id
+          type: string
+          description: (user.id)
+      returns:
+        - (User)
+  python:
+    - key: get_user
+      patternBefore: user_management.
+      id: get_user
+      url: /reference/user-management/user/get
+      title: user_management.get_user()
+      parameters:
+        - key: user_id
+          type: str
+          description: (user.id)
+      returns:
+        - (User)
+  ruby:
+    - key: get_user
+      id: get_user
+      url: /reference/user-management/user/get
+      title: UserManagement.get_user()
+      type: GET
+      parameters:
+        - key: id
+          type: String
+          description: (user.id)
+      returns:
+        - (User)
+  java:
+    - key: getUser
+      id: get_user
+      url: /reference/user-management/user/get
+      title: userManagement.getUser()
+      type: GET
+      parameters:
+        - key: userId
+          type: String
+          description: (user.id)
+      returns:
+        - (User)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/user-management/user/get.mdx
+---
+
+## Get a user
+
+Get the details of an existing user.
+
+<CodeBlock referenceId="get_user">
+  <CodeBlockTab title="Request" file="get-user-request" />
+  <CodeBlockTab title="Response" file="get-user-response" />
+</CodeBlock>