@workos/mcp-docs-server 0.1.0

package/.docs/organized/docs/reference/mfa/verify-challenge.mdx

@@ -0,0 +1,228 @@
+---
+descriptions:
+  verify_challenge:
+    authentication_challenge_id: The unique ID of the authentication Challenge.
+    code: The 6 digit code to be verified.
+    challenge: >-
+      The relevant [Authentication
+      Challenge](/reference/mfa/authentication-challenge).
+    valid: Indicates whether the code was correct.
+reference:
+  curl:
+    - key: verify_challenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: '/auth/challenges/:id/verify'
+      type: POST
+      parameters:
+        - key: authentication_challenge_id
+          type: string
+          description: (verify_challenge.authentication_challenge_id)
+        - key: code
+          type: string
+          description: (verify_challenge.code)
+      returns:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: challenge
+              type: challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: boolean
+              description: (verify_challenge.valid)
+  dotnet:
+    - key: VerifyChallenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: mfaService.VerifyChallenge()
+      parameters:
+        - key: options
+          type: VerifyChallengeOptions
+          expanded: true
+          properties:
+            - key: ChallengeId
+              type: string
+              description: (verify_challenge.authentication_challenge_id)
+            - key: Code
+              type: string
+              description: (verify_challenge.code)
+        - (cancellationToken)
+      returns:
+        - key: Task<VerifyChallengeResponse>
+          title: class VerifyChallengeResponse
+          expanded: true
+          properties:
+            - key: Challenge
+              type: Challenge
+              description: (verify_challenge.challenge)
+            - key: Valid
+              type: bool
+              description: (verify_challenge.valid)
+  ruby:
+    - key: verify_challenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: MFA.verify_challenge()
+      parameters:
+        - key: authentication_challenge_id
+          type: String
+          description: (verify_challenge.authentication_challenge_id)
+        - key: code
+          type: String
+          description: (verify_challenge.code)
+      returns:
+        - key: VerifyChallenge
+          type: Struct
+          unwrap: true
+          properties:
+            - key: challenge
+              type: Challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: bool
+              description: (verify_challenge.valid)
+  python:
+    - key: verify_challenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: mfa.verify_challenge()
+      parameters:
+        - key: authentication_challenge_id
+          type: str
+          description: (verify_challenge.authentication_challenge_id)
+        - key: code
+          type: str
+          description: (verify_challenge.code)
+      returns:
+        - key: anonymous
+          type: dict
+          unwrap: true
+          properties:
+            - key: challenge
+              type: authentication_challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: bool
+              description: (verify_challenge.valid)
+  js:
+    - key: verifyChallenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: mfa.verifyChallenge()
+      parameters:
+        - key: options
+          type: object
+          unwrap: true
+          properties:
+            - key: authenticationChallengeId
+              type: string
+              description: (verify_challenge.authentication_challenge_id)
+            - key: code
+              type: string
+              description: (verify_challenge.code)
+      returns:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: challenge
+              type: Challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: boolean
+              description: (verify_challenge.valid)
+  php:
+    - key: verifyChallenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: $mfa->verifyChallenge()
+      parameters:
+        - key: authenticationChallengeId
+          type: string
+          description: (verify_challenge.authentication_challenge_id)
+        - key: code
+          type: string
+          description: (verify_challenge.code)
+      returns:
+        - key: anonymous
+          type: array
+          unwrap: true
+          properties:
+            - key: challenge
+              type: Challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: bool
+              description: (verify_challenge.valid)
+  java:
+    - key: verifyChallenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: mfa.verifyChallenge()
+      parameters:
+        - key: options
+          type: VerifyChallengeOptions
+          expanded: true
+          properties:
+            - key: authenticationChallengeId
+              type: String
+              description: (verify_challenge.authentication_challenge_id)
+            - key: code
+              type: String
+              description: (verify_challenge.code)
+            - key: builder()
+              type: VerifyChallengeOptionsBuilder
+              description: (java.builder)
+      returns:
+        - key: response
+          type: VerifyChallengeResponse
+          expanded: true
+          properties:
+            - key: challenge
+              type: Challenge
+              description: (verify_challenge.challenge)
+            - key: valid
+              type: Boolean
+              description: (verify_challenge.valid)
+  go:
+    - key: VerifyChallenge
+      id: verify_challenge
+      url: /reference/mfa/verify-challenge
+      title: mfa.VerifyChallenge()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: mfa.VerifyChallengeOpts
+          expanded: true
+          properties:
+            - key: ChallengeID
+              type: string
+              description: (verify_challenge.authentication_challenge_id)
+            - key: Code
+              type: string
+              description: (verify_challenge.code)
+      returns:
+        - key: verify
+          type: mfa.VerifyChallengeResponse
+          expanded: true
+          properties:
+            - key: Challenge
+              type: mfa.Challenge
+              description: (verify_challenge.challenge)
+            - key: Valid
+              type: bool
+              description: (verify_challenge.valid)
+        - (err)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/verify-challenge.mdx
+---
+
+## Verify Challenge
+
+Verify Authentication Challenge.
+
+<CodeBlock referenceId="verify_challenge">
+  <CodeBlockTab title="Request" file="verify-challenge-request" />
+  <CodeBlockTab title="Response" file="verify-challenge-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/organization/create.mdx

@@ -0,0 +1,216 @@
+---
+descriptions:
+  domains_parameter: The domains of the Organization.
+reference:
+  curl:
+    - key: create_organization
+      type: POST
+      id: create_organization
+      url: /reference/organization/create
+      title: /organizations
+      parameters:
+        - (organization.name)
+        - key: domain_data
+          optional: true
+          type: array
+          properties:
+            - key: domain
+              type: string
+              description: (domain_data.domain)
+            - key: state
+              type: '"pending" | "verified"'
+              description: (domain_data.state)
+        - key: external_id
+          optional: true
+          type: string
+          description: (organization.external_id)
+        - key: metadata
+          optional: true
+          type: object
+          description: (organization.metadata)
+      returns:
+        - (organization)
+  js:
+    - key: createOrganization
+      id: create_organization
+      url: /reference/organization/create
+      title: organizations.createOrganization()
+      parameters:
+        - key: options
+          type: object
+          unwrap: true
+          properties:
+            - (Organization.name)
+            - key: domainData
+              optional: true
+              type: 'object[]'
+              properties:
+                - key: domain
+                  type: string
+                  description: (domain_data.domain)
+                - key: state
+                  type: '"pending" | "verified"'
+                  description: (domain_data.state)
+            - key: externalId
+              optional: true
+              type: string
+              description: (organization.external_id)
+            - key: metadata
+              optional: true
+              type: object
+              description: (organization.metadata)
+      returns:
+        - (Organization)
+  go:
+    - key: CreateOrganization
+      id: create_organization
+      url: /reference/organization/create
+      title: organizations.CreateOrganization()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: organizations.CreateOrganizationOpts
+          expanded: true
+          properties:
+            - (Organization.Name)
+            - key: DomainData
+              optional: true
+              type: '[]OrganizationDomainData'
+              properties:
+                - key: Domain
+                  type: string
+                  description: (domain_data.domain)
+                - key: State
+                  type: OrganizationDomainDataState
+                  description: (domain_data.state)
+      returns:
+        - key: org
+          type: organizations.Organization
+          description: (organization.self)
+        - (err)
+  java:
+    - key: createOrganization
+      id: create_organization
+      url: /reference/organization/create
+      title: organizations.createOrganization()
+      parameters:
+        - key: options
+          type: CreateOrganizationOptions
+          expanded: true
+          properties:
+            - (Organization.name)
+            - key: domainData
+              optional: true
+              type: List<OrganizationDomainDataOptions>
+              properties:
+                - key: domain
+                  type: String
+                  description: (domain_data.domain)
+                - key: state
+                  type: OrganizationDomainDataState
+                  description: (domain_data.state)
+            - key: builder()
+              type: CreateOrganizationOptionsBuilder
+              description: (java.builder)
+      returns:
+        - (Organization)
+  ruby:
+    - key: create_organization
+      id: create_organization
+      url: /reference/organization/create
+      title: Organizations.create_organization()
+      parameters:
+        - (Organization.name)
+        - key: domain_data
+          optional: true
+          type: 'Array[Hash]'
+          properties:
+            - key: domain
+              type: String
+              description: (domain_data.domain)
+            - key: state
+              type: '"pending" | "verified"'
+              description: (domain_data.state)
+      returns:
+        - (Organization)
+  python:
+    - key: create_organization
+      id: create_organization
+      url: /reference/organization/create
+      title: organizations.create_organization()
+      parameters:
+        - (Organization.name)
+        - key: domain_data
+          optional: true
+          type: 'Sequence[DomainDataInput]'
+          properties:
+            - key: domain
+              type: string
+              description: (domain_data.domain)
+            - key: state
+              type: '"pending" | "verified"'
+              description: (domain_data.state)
+        - key: idempotency_key
+          optional: true
+          type: str
+          description: (idempotency_key)
+      returns:
+        - (Organization)
+  php:
+    - key: createOrganization
+      id: create_organization
+      url: /reference/organization/create
+      title: $organizations->createOrganization()
+      parameters:
+        - (Organization.name)
+        - key: domain_data
+          optional: true
+          type: 'object[]'
+          properties:
+            - key: domain
+              type: string
+              description: (domain_data.domain)
+            - key: state
+              type: '"pending" | "verified"'
+              description: (domain_data.state)
+      returns:
+        - (Organization)
+  dotnet:
+    - key: CreateOrganization
+      id: create_organization
+      url: /reference/organization/create
+      title: organizationsService.CreateOrganization()
+      parameters:
+        - key: options
+          type: CreateOrganizationOptions
+          expanded: true
+          properties:
+            - (Organization.Name)
+            - key: DomainData
+              type: 'OrganizationDomainDataOptions[]'
+              optional: true
+              properties:
+                - key: Domain
+                  type: string
+                  description: (domain_data.domain)
+                - key: State
+                  type: OrganizationDomainDataState
+                  description: (domain_data.state)
+        - (idempotencyKey)
+        - (cancellationToken)
+      returns:
+        - key: Task<Organization>
+          description: (organization.self)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/create.mdx
+---
+
+## Create an Organization
+
+Creates a new organization in the current environment.
+
+You can include one or more domains to associate with the organization, but you should [verify the ownership](/user-management/domain-verification) of every domain before setting its state to `verified`.
+
+<CodeBlock referenceId="create_organization">
+  <CodeBlockTab title="Request" file="create-organization-request" />
+  <CodeBlockTab title="Response" file="create-organization-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/organization/delete.mdx

@@ -0,0 +1,89 @@
+---
+reference:
+  curl:
+    - key: delete_organization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: '/organizations/:id'
+      type: DELETE
+      parameters:
+        - (organization.id)
+  js:
+    - key: deleteOrganization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: organizations.deleteOrganization()
+      parameters:
+        - (Organization.id)
+  go:
+    - key: DeleteOrganization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: organizations.DeleteOrganization()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: organizations.DeleteOrganizationOpts
+          expanded: true
+          properties:
+            - key: Organization
+              type: string
+              description: (organization.id)
+      returns:
+        - (err)
+  java:
+    - key: deleteOrganization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: organizations.deleteOrganization()
+      parameters:
+        - (Organization.id)
+  ruby:
+    - key: delete_organization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: Organizations.delete_organization()
+      parameters:
+        - (Organization.id)
+  python:
+    - key: delete_organization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: organizations.delete_organization()
+      parameters:
+        - key: organization
+          type: str
+          description: (organization.id)
+  php:
+    - key: deleteOrganization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: $organizations->deleteOrganization()
+      parameters:
+        - key: organization
+          type: string
+          description: (organization.id)
+  dotnet:
+    - key: DeleteOrganization
+      id: delete_organization
+      url: /reference/organization/delete
+      title: organizationsService.DeleteOrganization()
+      parameters:
+        - key: id
+          type: string
+          description: (organization.id)
+        - (cancellationToken)
+      returns:
+        - (Task)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/delete.mdx
+---
+
+## Delete an Organization
+
+Permanently deletes an organization in the current environment. It cannot be undone.
+
+<CodeBlock
+  title="Request"
+  file="delete-organization"
+  referenceId="delete_organization"
+/>

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

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

package/.docs/organized/docs/reference/organization/get.mdx

@@ -0,0 +1,104 @@
+---
+reference:
+  curl:
+    - key: get_organization
+      id: get_organization
+      url: /reference/organization/get
+      title: '/organizations/:id'
+      type: GET
+      parameters:
+        - (organization.id)
+      returns:
+        - (organization)
+  js:
+    - key: getOrganization
+      id: get_organization
+      url: /reference/organization/get
+      title: organizations.getOrganization()
+      parameters:
+        - (Organization.id)
+      returns:
+        - (Organization)
+  go:
+    - key: GetOrganization
+      id: get_organization
+      url: /reference/organization/get
+      title: organizations.GetOrganization()
+      parameters:
+        - (ctx)
+        - key: opts
+          type: organizations.GetOrganizationOpts
+          expanded: true
+          properties:
+            - key: Organization
+              type: string
+              description: (organization.id)
+      returns:
+        - key: org
+          type: organizations.Organization
+          description: (organization.self)
+        - (err)
+  java:
+    - key: getOrganization
+      id: get_organization
+      url: /reference/organization/get
+      title: organizations.getOrganization()
+      parameters:
+        - (Organization.id)
+      returns:
+        - (Organization)
+  ruby:
+    - key: get_organization
+      id: get_organization
+      url: /reference/organization/get
+      title: Organizations.get_organization()
+      parameters:
+        - (Organization.id)
+      returns:
+        - (Organization)
+  python:
+    - key: get_organization
+      id: get_organization
+      url: /reference/organization/get
+      title: organizations.get_organization()
+      parameters:
+        - key: organization_id
+          type: str
+          description: (organization.id)
+      returns:
+        - (Organization)
+  php:
+    - key: getOrganization
+      id: get_organization
+      url: /reference/organization/get
+      title: $organizations->getOrganization()
+      parameters:
+        - key: organization
+          type: string
+          description: (organization.id)
+      returns:
+        - (Organization)
+  dotnet:
+    - key: GetOrganization
+      id: get_organization
+      url: /reference/organization/get
+      title: organizationsService.GetOrganization()
+      parameters:
+        - key: id
+          type: string
+          description: (organization.id)
+        - (cancellationToken)
+      returns:
+        - key: Task<Organization>
+          description: (organization.self)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/get.mdx
+---
+
+## Get an Organization
+
+Get the details of an existing organization.
+
+<CodeBlock referenceId="get_organization">
+  <CodeBlockTab title="Request" file="get-organization-request" />
+  <CodeBlockTab title="Response" file="get-organization-response" />
+</CodeBlock>