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

# Actualizar configuraciones del Ledger

> Utilice este endpoint para actualizar parcialmente las configuraciones de un Ledger específico. Utiliza deep merge — solo los campos incluidos en el cuerpo de la solicitud son modificados.



## OpenAPI

````yaml es/openapi/v3-current/ledger.yaml patch /v1/organizations/{organization_id}/ledgers/{ledger_id}/settings
openapi: 3.1.0
info:
  title: API de Midaz Ledger
  description: >-
    Referencia completa de la API para los servicios de Midaz Ledger, incluyendo
    gestión de organizaciones, operaciones de ledger, activos, segmentos,
    portafolios, cuentas, tipos de cuenta, transacciones, operaciones, saldos,
    rutas de operación, rutas de transacción e índices de metadatos.
  version: 3.7.8
servers:
  - url: https://ledger.sandbox.lerian.net
security: []
tags:
  - name: Organizations API
  - name: Ledgers API
  - name: Assets API
  - name: Segments API
  - name: Portfolios API
  - name: Account Types API
  - name: Accounts API
  - name: Balances API
  - name: Transactions API
  - name: Operations API
  - name: Operation Routes API
  - name: Transaction Routes API
  - name: Metadata Indexes API
  - name: Holders API
  - name: Instruments API
  - name: Billing Packages API
  - name: Packages API
  - name: Billing Calculation API
  - name: Estimation API
  - name: Encryption API
  - name: Protection API
  - name: Asset Rates API
paths:
  /v1/organizations/{organization_id}/ledgers/{ledger_id}/settings:
    patch:
      tags:
        - Ledgers API
      summary: Actualizar configuraciones del Ledger
      description: >-
        Utilice este endpoint para actualizar parcialmente las configuraciones
        de un Ledger específico. Utiliza deep merge — solo los campos incluidos
        en el cuerpo de la solicitud son modificados.
      parameters:
        - $ref: '#/components/parameters/OrganizationId'
        - $ref: '#/components/parameters/LedgerId'
        - $ref: '#/components/parameters/ContentType'
        - $ref: '#/components/parameters/XRequestId'
        - $ref: '#/components/parameters/Authorization'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateLedgerSettingsRequest'
            example:
              accounting:
                validateRoutes: true
      responses:
        '200':
          description: >-
            Indica que la solicitud fue exitosa y las configuraciones fueron
            actualizadas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LedgerSettingsResponse'
              example:
                accounting:
                  validateAccountType: false
                  validateRoutes: true
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0147:
                  $ref: '#/components/examples/Error0147'
                Error0148:
                  $ref: '#/components/examples/Error0148'
                Error0149:
                  $ref: '#/components/examples/Error0149'
                Error0143:
                  $ref: '#/components/examples/Error0143'
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0041:
                  $ref: '#/components/examples/Error0041'
                Error0042:
                  $ref: '#/components/examples/Error0042'
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0043:
                  $ref: '#/components/examples/Error0043'
        '404':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0007:
                  $ref: '#/components/examples/Error0007'
        '500':
          description: Error Interno del Servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0046:
                  $ref: '#/components/examples/Error0046'
components:
  parameters:
    OrganizationId:
      name: organization_id
      in: path
      description: El identificador único de la Organización asociada al Ledger.
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
        format: uuid
    LedgerId:
      name: ledger_id
      in: path
      description: El identificador único del Ledger asociado.
      required: true
      example: 019c96a0-0ac0-7de9-9f53-9cf842a2ee5a
      schema:
        type: string
        format: uuid
    ContentType:
      name: Content-Type
      in: header
      description: >-
        El tipo de medio del recurso. El valor recomendado es
        `application/json`.
      required: false
      example: application/json
      schema:
        type: string
    XRequestId:
      name: X-Request-Id
      in: header
      description: Un identificador único utilizado para rastrear y seguir cada solicitud.
      required: false
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
        format: uuid
    Authorization:
      name: Authorization
      in: header
      required: false
      schema:
        type: string
      description: >
        Token JWT bearer para autenticación.

        Requerido cuando `PLUGIN_AUTH_ENABLED=true` (obligatorio en despliegues
        multiinquilino).

        Opcional en el modo OSS de inquilino único predeterminado.

        Formato: `Bearer <token>`
  schemas:
    UpdateLedgerSettingsRequest:
      type: object
      description: >-
        Actualización parcial de las configuraciones del Ledger. Utiliza deep
        merge — solo los campos que incluya son modificados.
      properties:
        accounting:
          type: object
          description: Configuraciones relacionadas con la contabilidad del Ledger.
          properties:
            validateAccountType:
              type: boolean
              description: >-
                Habilitar o deshabilitar la validación de tipo de cuenta para
                transacciones.
            validateRoutes:
              type: boolean
              description: >-
                Habilitar o deshabilitar la validación de rutas para
                transacciones.
    LedgerSettingsResponse:
      type: object
      description: Las configuraciones actuales de un Ledger.
      properties:
        accounting:
          type: object
          description: Configuraciones relacionadas con la contabilidad del Ledger.
          properties:
            validateAccountType:
              type: boolean
              description: >-
                Cuando está habilitado, valida que los tipos de cuenta coincidan
                con las reglas definidas en las rutas de operación durante el
                procesamiento de transacciones.
            validateRoutes:
              type: boolean
              description: >-
                Cuando está habilitado, cada transacción en este Ledger debe
                tener una ruta de transacción asociada. Las operaciones también
                se validan contra las reglas de sus rutas de operación.
    ErrorFormat:
      type: object
      description: El mensaje de error de respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
        entityType:
          type: string
          description: >-
            El tipo de entidad a la que se refiere el error (p. ej.
            organization, ledger, account, transaction). Opcional.
        fields:
          type: object
          additionalProperties: true
          description: Información adicional sobre los campos que causaron el error.
  examples:
    Error0147:
      summary: Unknown Settings Field
      value:
        code: '0147'
        title: Unknown Settings Field
        message: >-
          The provided field is not recognized in the settings configuration.
          Only known fields are accepted.
    Error0148:
      summary: Invalid Settings Field Type
      value:
        code: '0148'
        title: Invalid Settings Field Type
        message: >-
          The provided value has an incompatible type for the specified field
          (e.g., a string was provided for a boolean field).
    Error0149:
      summary: Settings Field at Root Level
      value:
        code: '0149'
        title: Settings Field at Root Level
        message: >-
          The field must be nested under the correct parent object (e.g., use
          accounting.validateRoutes instead of validateRoutes at the root
          level).
    Error0143:
      summary: Payload Too Large
      value:
        code: '0143'
        title: Payload Too Large
        message: The request body exceeds the 64 KB limit.
    Error0041:
      summary: Token Missing
      value:
        code: '0041'
        title: Token Missing
        message: >-
          A valid token must be provided in the request header. Please include a
          token and try again.
    Error0042:
      summary: Invalid Token
      value:
        code: '0042'
        title: Invalid Token
        message: >-
          The provided token is expired, invalid or malformed. Please provide a
          valid token and try again.
    Error0043:
      summary: Insufficient Privileges
      value:
        code: '0043'
        title: Insufficient Privileges
        message: >-
          You do not have the necessary permissions to perform this action.
          Please contact your administrator if you believe this is an error.
    Error0007:
      value:
        code: '0007'
        title: Entity Not Found
        message: >-
          No entity was found for the given ID. Please make sure to use the
          correct ID for the entity you are trying to manage.
      summary: Entity Not Found
    Error0046:
      summary: Internal Server Error
      value:
        code: '0046'
        title: Internal Server Error
        message: >-
          The server encountered an unexpected error. Please try again later or
          contact support.

````