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

# Apply a manual balance adjustment

> Updates an account balance directly and records a manual adjustment in the transaction ledger via database trigger.



## OpenAPI

````yaml /openapi/openapi.json post /api/accounts/{id}/manual-balance
openapi: 3.0.0
info:
  title: FinSync API Documentation
  version: 1.0.0
  description: API documentation for FinSync application
  contact:
    name: FinSync Support
    email: support@finsync.com
servers:
  - url: https://finsync.ar
    description: API server
security:
  - apiKey: []
tags:
  - name: Clients
    description: Operations related to clients and their accounts
  - name: Accounts
    description: Operations related to account balances
  - name: Operations
    description: Operations for creating and managing financial operations
  - name: Operation Types
    description: Company operation types management
  - name: Transaction Types
    description: Company transaction types management
  - name: Superadmin
    description: Cross-tenant operations (JWT + email allowlist)
  - name: External client
    description: >-
      Exports for external (portal-linked) clients. Authenticate with
      `x-api-key` (company-owned client ID) or `Authorization: Bearer` (Supabase
      access token with an ExternalClient invite).
paths:
  /api/accounts/{id}/manual-balance:
    post:
      tags:
        - Accounts
      summary: Apply a manual balance adjustment
      description: >-
        Updates an account balance directly and records a manual adjustment in
        the transaction ledger via database trigger.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: integer
          description: Account ID to adjust
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                balance:
                  type: number
                  description: New absolute balance for the account
                adjustment:
                  type: number
                  description: Balance delta to apply (positive or negative)
              description: Provide either balance or adjustment (not both)
      responses:
        '200':
          description: Balance updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  account_id:
                    type: integer
                  balance_before:
                    type: number
                  balance_after:
                    type: number
                  adjustment:
                    type: number
        '400':
          description: Bad request - Invalid account ID or payload
        '401':
          description: Unauthorized - Missing or invalid API key
        '404':
          description: Account not found
        '500':
          description: Server error
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````