> ## Documentation Index
> Fetch the complete documentation index at: https://docs.henrylabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Disconnect

> Disconnect a buyer's connected login at a store and erase it: Henry no longer holds the username or the password, and stops using it at once; the buyer's later purchases at that store are refused until a login is connected again.



## OpenAPI

````yaml /v1/api-reference/openapi.documented.json post /account/disconnect
openapi: 3.1.0
info:
  title: Henry Labs API
  version: 1.18.0
  description: Playground for Henry Labs API endpoints
  contact:
    name: Henry Labs API Support
    email: support@henrylabs.ai
servers:
  - url: https://api.henrylabs.ai/v1
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Product
    description: Product search, details, and data enrichment
  - name: Cart
    description: Universal user shopping cart management
  - name: Orders
    description: Order management post purchase
  - name: Merchants
    description: Merchant information and status
  - name: Card
    description: Card tokenization and management
  - name: Account
    description: Buyers' own logins at stores that check out on customers' own accounts
paths:
  /account/disconnect:
    post:
      tags:
        - Account
      summary: Account Disconnect
      description: >-
        Disconnect a buyer's connected login at a store and erase it: Henry no
        longer holds the username or the password, and stops using it at once;
        the buyer's later purchases at that store are refused until a login is
        connected again.
      operationId: accountDisconnect
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/accountDisconnectInput'
      responses:
        '200':
          description: Login disconnected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/accountDisconnectResponse'
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: string
                  message:
                    type: string
                required:
                  - success
                  - status
                  - message
                additionalProperties: false
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: string
                  message:
                    type: string
                required:
                  - success
                  - status
                  - message
                additionalProperties: false
        '404':
          description: No store with this host, or no login connected for this buyer there
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: string
                  message:
                    type: string
                required:
                  - success
                  - status
                  - message
                additionalProperties: false
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import HenrySDK from '@henrylabs/sdk';

            const client = new HenrySDK({
              apiKey: process.env['HENRY_SDK_API_KEY'], // This is the default and can be omitted
            });

            const response = await client.account.disconnect({
              buyerEmail: 'jane@example.com',
              merchantHost: 'uniqlo.com',
            });

            console.log(response.data);
components:
  schemas:
    accountDisconnectInput:
      type: object
      properties:
        merchantHost:
          type: string
          minLength: 1
          description: >-
            The store, by the host Henry names it with (for example
            `uniqlo.com`). A URL is accepted and reduced to its host; a leading
            `www.` is ignored.
          example: uniqlo.com
        buyerEmail:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
          description: >-
            The buyer the login belongs to: the `buyer.email` your purchases at
            this store carry. Matched case-insensitively.
          example: jane@example.com
      required:
        - merchantHost
        - buyerEmail
    accountDisconnectResponse:
      type: object
      properties:
        success:
          type: boolean
        status:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/connectedAccount'
      required:
        - success
        - status
        - message
        - data
      additionalProperties: false
    connectedAccount:
      type: object
      properties:
        merchantHost:
          type: string
          description: The store the login is for.
          example: uniqlo.com
        buyerEmail:
          type: string
          description: The buyer the login belongs to, lowercased.
          example: jane@example.com
        status:
          type: string
          enum:
            - connected
            - failed
            - disconnected
          description: >-
            `connected`: purchases for this buyer at this store sign in with it.
            `failed`: the store would not sign in with it (the password was
            rejected, the account is locked, or the store asked for a check only
            the buyer can complete), so purchases there are refused until you
            connect the login again. `disconnected`: it was removed and erased,
            and is no longer used.
          example: connected
        connectedAt:
          type: string
          description: When the login was first connected (ISO 8601).
          example: '2026-11-12T23:00:00.000Z'
      required:
        - merchantHost
        - buyerEmail
        - status
        - connectedAt
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.