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

# Delete a customer

> Deletes the specified customer. This is a soft delete: the customer is marked as deleted and no longer appears in list or retrieve responses, but historical records that reference the customer (such as payment intents and checkout sessions) continue to resolve it.



## OpenAPI

````yaml /openapi.json delete /v1/customers/{id}
openapi: 3.1.0
info:
  title: Flex API
  description: >-
    The Flex API powers HSA/FSA payment processing for healthcare commerce:
    checkout sessions, payment intents, subscriptions, customers, refunds,
    disputes, and eligibility. Authenticate with your partner API key as a
    Bearer token. All endpoints are scoped to your partner account, and test
    mode is fully supported via test API keys.
  version: 0.1.0
servers:
  - url: https://api.withflex.com
security:
  - BearerAuth: []
tags:
  - name: Balance Transactions
  - name: Captures
  - name: Checkout Sessions
  - name: Coupons
  - name: Customers
  - name: Disputes
  - name: Events
  - name: Exports
  - name: Files
  - name: Invoices
  - name: Letters
  - name: Orders
  - name: Payment Intents
  - name: Payment Links
  - name: Payouts
  - name: Prices
  - name: Products
  - name: Promo Codes
  - name: Receipts
  - name: Refunds
  - name: Setup Intents
  - name: Shipping Rates
  - name: Subscriptions
paths:
  /v1/customers/{id}:
    delete:
      tags:
        - Customers
      summary: Delete a customer
      description: >-
        Deletes the specified customer. This is a soft delete: the customer is
        marked as deleted and no longer appears in list or retrieve responses,
        but historical records that reference the customer (such as payment
        intents and checkout sessions) continue to resolve it.
      operationId: v1.customer.delete
      parameters:
        - in: path
          name: id
          required: true
          schema:
            examples:
              - fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA
            type: string
          style: simple
          example: fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA
      responses:
        '200':
          description: An envelope wrapping a single customer object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerBody_for_DeletedCustomerResponse'
              example:
                customer:
                  customer_id: fcus_01HACM7FZ1084XB1GB6053VM0D
                  deleted: true
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpErrorOut'
              example:
                code: string
                detail: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpErrorOut'
              example:
                code: string
                detail: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpErrorOut'
              example:
                code: string
                detail: string
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpErrorOut'
              example:
                code: string
                detail: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
              example:
                detail:
                  - loc:
                      - string
                    msg: string
                    type: string
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpErrorOut'
              example:
                code: string
                detail: string
      security:
        - BearerAuth:
            - customers:write
components:
  schemas:
    CustomerBody_for_DeletedCustomerResponse:
      description: An envelope wrapping a single customer object.
      type: object
      required:
        - customer
      properties:
        customer:
          $ref: '#/components/schemas/DeletedCustomerResponse'
          description: The customer.
      example:
        customer:
          customer_id: fcus_01HACM7FZ1084XB1GB6053VM0D
          deleted: true
    HttpErrorOut:
      title: HttpError
      description: The error response returned when a request cannot be completed.
      type: object
      required:
        - code
        - detail
      properties:
        code:
          description: A short machine-readable error code identifying the type of error.
          type: string
        detail:
          description: A human-readable explanation of what went wrong.
          type: string
      example:
        code: string
        detail: string
    HTTPValidationError:
      description: The error response returned when request validation fails (HTTP 422).
      type: object
      required:
        - detail
      properties:
        detail:
          description: The list of validation errors, one entry per invalid field.
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorItem'
      example:
        detail:
          - loc:
              - string
            msg: string
            type: string
    DeletedCustomerResponse:
      description: >-
        The response returned when a customer is deleted, confirming the
        deletion.
      type: object
      required:
        - customer_id
        - deleted
      properties:
        customer_id:
          description: ID of the deleted Customer.
          type: string
          example: fcus_01HACM7FZ1084XB1GB6053VM0D
        deleted:
          description: Always `true`, confirming the customer was deleted.
          type: boolean
          example: true
      example:
        customer_id: fcus_01HACM7FZ1084XB1GB6053VM0D
        deleted: true
    ValidationErrorItem:
      description: >-
        Validation errors have their own schema to provide context for invalid
        requests eg. mismatched types and out of bounds values. There may be any
        number of these per 422 UNPROCESSABLE ENTITY error.
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          description: >-
            The location as a [`Vec`] of [`String`]s -- often in the form
            `["body", "field_name"]`, `["query", "field_name"]`, etc. They may,
            however, be arbitarily deep.
          type: array
          items:
            type: string
        msg:
          description: The message accompanying the validation error item.
          type: string
        type:
          description: >-
            The type of error, often "type_error" or "value_error", but
            sometimes with more context like as "value_error.number.not_ge"
          type: string
      example:
        loc:
          - string
        msg: string
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Use a Bearer token to access this API.

````