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

# Delete account

> Deactivates an accounting number on the organization's chart of accounts so it can no longer be used to categorise new expenses. The operation is a soft delete — the account is marked inactive rather than removed from the database. Cannot be used when the organization's accounting numbers are synced from an external system (returns 403 in that case).



## OpenAPI

````yaml openapi/findity-admin-api.json DELETE /organizations/{id}/accounts/{accountId}
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /organizations/{id}/accounts/{accountId}:
    delete:
      tags:
        - Organization
      summary: Delete account
      description: >-
        Deactivates an accounting number on the organization's chart of accounts
        so it can no longer be used to categorise new expenses. The operation is
        a soft delete — the account is marked inactive rather than removed from
        the database. Cannot be used when the organization's accounting numbers
        are synced from an external system (returns 403 in that case).
      operationId: adminDeleteAccount
      parameters:
        - $ref: '#/components/parameters/organizationIdPath'
        - in: path
          name: accountId
          required: true
          description: The account id
          schema:
            $ref: '#/components/schemas/Uuid'
      responses:
        '204':
          description: No content
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
              examples:
                account not found:
                  value:
                    result: error
                    code: ACCOUNT_NOT_FOUND
                    description: Account not found
                not allowed to delete account:
                  value:
                    result: error
                    description: Accounting number is synced from external system
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Error'
              example:
                result: error
                description: Accounting number is synced from external system
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              example:
                result: error
                code: ORGANIZATION_NOT_FOUND
                description: Organization not found
components:
  parameters:
    organizationIdPath:
      in: path
      name: id
      required: true
      description: The unique identifier of the organization
      schema:
        $ref: '#/components/schemas/Uuid'
        example: 05b8daba9ba14a49846fe77883248cf0
  schemas:
    Uuid:
      type: string
      pattern: ^[0-9a-fA-F]{32}$
      description: UUID without dashes (32-character hex string)
    400Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````