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

# Remove a beneficial owner

> Removes a beneficial owner from an account.



## OpenAPI

````yaml apis/fx-account/openapi.yml DELETE /v1/accounts/{accountId}/ubos/{uboId}
openapi: 3.1.1
info:
  title: FX Account API
  version: 1.0.0
  description: API for managing multi-currency accounts on the Trace Finance platform.
servers:
  - url: https://api.sandbox.tracefinance.com
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Accounts
    description: Create, list, and manage multi-currency accounts.
  - name: Beneficial owners
    description: Manage beneficial owners (UBOs) for company-owned accounts.
  - name: Funding instructions
    description: Retrieve funding instructions for depositing into an account.
  - name: Balances
    description: Retrieve fiat and crypto balances for an account.
paths:
  /v1/accounts/{accountId}/ubos/{uboId}:
    delete:
      tags:
        - Beneficial owners
      summary: Remove a beneficial owner
      description: Removes a beneficial owner from an account.
      operationId: removeUbo
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UboId'
        - $ref: '#/components/parameters/TraceVersion'
      responses:
        '204':
          description: Beneficial owner removed.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          description: Account or beneficial owner not found.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                accountNotFound:
                  $ref: '#/components/examples/AccountNotFound'
                uboNotFound:
                  $ref: '#/components/examples/UboNotFound'
        '422':
          description: Business rule violation.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ubosNotAllowedForIndividual:
                  summary: >-
                    Account has an individual owner (UBOs apply only to
                    companies)
                  value:
                    code: UBOS_NOT_ALLOWED_FOR_INDIVIDUAL
                    message: UBOs are not allowed for individual accounts
                    details:
                      taxId: '12345678900'
                accountNotModifiable:
                  summary: Account is not in a modifiable state
                  value:
                    code: ACCOUNT_NOT_MODIFIABLE
                    message: Account is not in a modifiable state
                    details:
                      accountId: 5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c
                approvedUbo:
                  summary: Cannot remove a UBO that has already been approved
                  value:
                    code: APPROVED_UBO
                    message: Cannot modify an approved UBO
                    details:
                      uboId: a1b2c3d4-e5f6-7890-1234-567890abcdef
components:
  parameters:
    AccountId:
      name: accountId
      in: path
      required: true
      description: UUID of the account.
      schema:
        type: string
        format: uuid
    UboId:
      name: uboId
      in: path
      required: true
      description: UUID of the beneficial owner.
      schema:
        type: string
        format: uuid
    TraceVersion:
      name: X-Trace-Version
      in: header
      required: false
      description: API version. Omit to use the default version.
      schema:
        type: string
        example: '1'
  headers:
    RequestId:
      description: >-
        Unique request identifier emitted on every response. Reference it when
        contacting Trace Finance support so we can trace the request end-to-end.
        See [Errors](/guides/principles/errors).
      schema:
        type: string
        format: uuid
  responses:
    UnauthorizedError:
      description: Missing or invalid authentication token.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalidToken:
              $ref: '#/components/examples/InvalidToken'
            expiredToken:
              $ref: '#/components/examples/ExpiredToken'
  schemas:
    ErrorResponse:
      type: object
      description: >-
        Standard error envelope. The HTTP response also carries an
        `X-Request-Id` header — reference it when contacting Trace Finance
        support. See [Errors](/guides/principles/errors).
      properties:
        code:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Human-readable description.
        details:
          type: object
          additionalProperties: true
      required:
        - code
        - message
  examples:
    AccountNotFound:
      summary: Account does not exist for the authenticated customer
      value:
        code: RESOURCE_NOT_FOUND
        message: >-
          Account with given parameters
          [Account.id:5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c,
          Customer.id:c1a2b3c4-d5e6-7890-abcd-ef1234567890] not found
        details:
          resource: Account
          parameters:
            Account.id: 5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c
            Customer.id: c1a2b3c4-d5e6-7890-abcd-ef1234567890
    UboNotFound:
      summary: Beneficial owner does not exist on the account
      value:
        code: RESOURCE_NOT_FOUND
        message: >-
          UBO with given parameters
          [UBO.id:a1b2c3d4-e5f6-7890-1234-567890abcdef] not found
        details:
          resource: UBO
          parameters:
            UBO.id: a1b2c3d4-e5f6-7890-1234-567890abcdef
    InvalidToken:
      summary: Bearer token is invalid or malformed
      value:
        code: INVALID_ACCESS_TOKEN
        message: Invalid access token
        details: {}
    ExpiredToken:
      summary: Bearer token has expired
      value:
        code: EXPIRED_ACCESS_TOKEN
        message: Expired access token
        details: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT bearer token. Include as `Authorization: Bearer <token>`. See the
        [Authentication](/guides/authentication) guide for how to obtain one.

````