> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.fidly.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Bank Account

> Update the editable fields of a bank account.

Only the fields present in the body are applied; the others keep their value. A request
that breaks a rule is refused **as a whole**: the account is left completely untouched,
never half-updated.



## OpenAPI

````yaml /openapi.json patch /bank-accounts/{account_uuid}
openapi: 3.1.0
info:
  title: Fidly API
  version: 1.0.0
servers:
  - url: https://api.fidly.be
    description: Production
security: []
paths:
  /bank-accounts/{account_uuid}:
    patch:
      tags:
        - bank accounts
      summary: Update Bank Account
      description: >-
        Update the editable fields of a bank account.


        Only the fields present in the body are applied; the others keep their
        value. A request

        that breaks a rule is refused **as a whole**: the account is left
        completely untouched,

        never half-updated.
      operationId: update_bank_account_bank_accounts__account_uuid__patch
      parameters:
        - name: account_uuid
          in: path
          required: true
          schema:
            type: string
            title: Account Uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankAccountUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankAccountOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    BankAccountUpdate:
      properties:
        title:
          anyOf:
            - type: string
              maxLength: 500
            - type: 'null'
          title: Title
          description: Name of the account.
        reference:
          anyOf:
            - type: string
              maxLength: 100
            - type: 'null'
          title: Reference
          description: >-
            The account's IBAN, validated (ISO 13616 structure and check digits)
            and stored uppercase without spaces. Editable only on a `manual`
            account: on a `ponto` or `coda` account it is owned by the bank
            feed.
        bic:
          anyOf:
            - type: string
              maxLength: 11
            - type: 'null'
          title: Bic
          description: >-
            BIC/SWIFT code. Editable only on a `manual` account, like
            `reference`.
        display_on_invoice:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Display On Invoice
          description: Whether this account is printed on the invoices the company issues.
        default:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Default
          description: >-
            Makes this account the company's default. Setting it to `true`
            demotes the previous default in the same operation. A company must
            always keep exactly one default, so setting it to `false` is
            refused: promote another account instead.
      additionalProperties: false
      type: object
      title: BankAccountUpdate
      description: >-
        The editable part of a bank account. Every field is optional: only the
        ones actually

        present in the request body are applied, so omitting a field leaves it
        untouched.


        Any other field of the account (`origin`, the balances, `currency`, the
        timestamps...) is

        read-only and rejected if sent, rather than ignored — a typo in a field
        name is an error,

        not a silent no-op.
    BankAccountOut:
      properties:
        id:
          type: string
          title: Id
          description: Opaque unique identifier of the bank account.
        origin:
          type: string
          title: Origin
          description: >-
            How the account came into Fidly. One of: `ponto` (synchronised
            through the banking connection), `coda` (created from a CODA
            statement), `manual`.
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Name of the account.
        reference:
          anyOf:
            - type: string
            - type: 'null'
          title: Reference
          description: Account reference, usually the IBAN.
        bic:
          anyOf:
            - type: string
            - type: 'null'
          title: Bic
          description: BIC/SWIFT code of the institution.
        current_balance:
          anyOf:
            - type: number
            - type: 'null'
          title: Current Balance
          description: Current balance of the account.
        available_balance:
          anyOf:
            - type: number
            - type: 'null'
          title: Available Balance
          description: Balance actually available for spending.
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
          description: ISO 4217 currency code of the balances (e.g. `EUR`).
        default:
          type: boolean
          title: Default
          description: '`true` when this is the company''s default account.'
        display_on_invoice:
          type: boolean
          title: Display On Invoice
          description: >-
            `true` when this account is printed on the invoices the company
            issues.
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
          description: When the account was added to Fidly (ISO 8601).
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: When the account was last modified (ISO 8601).
      additionalProperties: true
      type: object
      required:
        - id
        - origin
        - title
        - reference
        - bic
        - current_balance
        - available_balance
        - currency
        - default
        - display_on_invoice
        - created_at
        - updated_at
      title: BankAccountOut
      description: >-
        A bank account of the company, identified by an opaque `id`.


        Balances are decimal numbers in the account's `currency`; they are
        `null` for accounts

        Fidly does not synchronise (a `manual` account carries no balance).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````