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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Actualizar cuenta

> Actualiza los detalles de una cuenta bancaria existente en Banking Connectivity

Actualiza una cuenta existente de Banking Connectivity. Incluye solo los campos que quieres cambiar.


## OpenAPI

````yaml openapi/es/banking-connectivity/accounts/update-account-banking.json PATCH /banking/accounts/{account_id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Banking Connectivity
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - public-api-key: []
    private-secret-key: []
paths:
  /banking/accounts/{account_id}:
    patch:
      tags:
        - Accounts (Banking Connectivity)
      summary: Actualizar cuenta (Banking Connectivity)
      operationId: patch_v1-banking-connectivity-accounts-account-id
      parameters:
        - in: path
          name: account_id
          schema:
            type: string
          required: true
          description: >-
            El identificador único de la cuenta. Lo encuentras en el [Dashboard
            de Yuno](https://dashboard.y.uno/) (UUID, 36 caracteres).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                account_type:
                  type: string
                  description: >-
                    El tipo de cuenta. No se puede cambiar: enviar un valor
                    distinto del tipo almacenado devuelve 400
                    `ACCOUNT_TYPE_CHANGE_NOT_ALLOWED`.
                  example: CHECKING
                  enum:
                    - CHECKING
                    - SAVINGS
                    - INVESTMENT
                status:
                  type: string
                  description: >-
                    El estado de la cuenta. Los valores permitidos son `ACTIVE`,
                    `PENDING` y `FAILED`. Establecer `INACTIVE` devuelve 400
                    `ACCOUNT_STATUS_CHANGE_NOT_ALLOWED`; usa [Close
                    Account](/es/reference/banking-connectivity/accounts/close-account-banking)
                    en su lugar.
                  example: ACTIVE
                  enum:
                    - ACTIVE
                    - PENDING
                    - FAILED
                account_number:
                  type: string
                  description: El número de cuenta.
                  example: '1234567890'
                routing_number:
                  type: string
                  description: El número de ruta (EE. UU.).
                  example: '123456789'
                iban:
                  type: string
                  description: El IBAN (UE).
                  example: DE89370400440532013000
                balance:
                  type: object
                  description: El saldo de la cuenta.
                  properties:
                    available:
                      type: number
                      example: 1000
                    current:
                      type: number
                      example: 1000
                    pending:
                      type: number
                      example: 0
                    currency:
                      type: string
                      description: Moneda del saldo (ISO 4217).
                      example: USD
                payment_rails:
                  type: object
                  description: Los rieles de pago que admite la cuenta.
                  properties:
                    incoming:
                      type: array
                      items:
                        type: string
                      example:
                        - ACH
                        - WIRE
                    outgoing:
                      type: array
                      items:
                        type: string
                      example:
                        - ACH
                        - WIRE
                provider:
                  type: object
                  description: Detalles de la cuenta del lado del proveedor.
                  properties:
                    name:
                      type: string
                      description: Nombre del proveedor.
                    account_id:
                      type: string
                      description: El identificador de la cuenta en el proveedor.
                      example: col_bank_account_789
                    status:
                      type: string
                      description: El estado de la cuenta en el proveedor.
                    metadata:
                      type: object
                      description: Metadatos del proveedor de formato libre.
              description: >-
                Todos los campos son opcionales. Envía solo los campos que
                quieras cambiar. La cuenta se identifica con el parámetro de
                ruta `account_id`, por lo que el cuerpo no lo repite.
            examples:
              Update Account:
                summary: Update Account
                value:
                  status: ACTIVE
                  routing_number: '123456789'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: >-
                      El identificador único de la cuenta de Banking
                      Connectivity (UUID, 36 caracteres).
                    example: aa0e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    description: El `id` de la entidad asociada a esta cuenta.
                    example: 660e8400-e29b-41d4-a716-446655440000
                  onboarding_id:
                    type: string
                    description: El `id` del onboarding usado para crear esta cuenta.
                    example: 990e8400-e29b-41d4-a716-446655440000
                  account_id:
                    type: string
                    description: El identificador de la cuenta de Yuno del comercio.
                    example: 550e8400-e29b-41d4-a716-446655440000
                  provider:
                    type: object
                    properties:
                      account_id:
                        type: string
                        example: col_bank_account_789
                  account_type:
                    type: string
                    enum:
                      - CHECKING
                      - SAVINGS
                      - INVESTMENT
                    example: CHECKING
                  status:
                    type: string
                    enum:
                      - ACTIVE
                      - PENDING
                      - INACTIVE
                    example: ACTIVE
                  account_number:
                    type: string
                    example: '1234567890'
                  routing_number:
                    type: string
                    nullable: true
                    example: '123456789'
                  iban:
                    type: string
                    nullable: true
                    example: null
                  currency:
                    type: string
                    example: USD
                  balance:
                    type: object
                    properties:
                      available:
                        type: number
                        example: 5000
                      current:
                        type: number
                        example: 5000
                      pending:
                        type: number
                        example: 0
                  account_details:
                    type: object
                    properties:
                      account_name:
                        type: string
                        example: John Doe - Primary Checking
                      sort_code:
                        type: string
                        nullable: true
                        example: null
                      bsb:
                        type: string
                        nullable: true
                        example: null
                      swift:
                        type: string
                        nullable: true
                        example: null
                  payment_rails:
                    type: object
                    properties:
                      incoming:
                        type: array
                        items:
                          type: string
                        example:
                          - ACH
                          - WIRE
                      outgoing:
                        type: array
                        items:
                          type: string
                        example:
                          - ACH
                          - WIRE
                  supports_book_transfers:
                    type: boolean
                    example: true
                  created_at:
                    type: string
                    example: '2026-02-01T10:10:00Z'
                  updated_at:
                    type: string
                    example: '2026-02-01T12:00:00Z'
              examples:
                OK (Updated Account):
                  summary: OK (Updated Account)
                  value:
                    id: aa0e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    onboarding_id: 990e8400-e29b-41d4-a716-446655440000
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    provider:
                      account_id: col_bank_account_789
                    account_type: CHECKING
                    status: ACTIVE
                    account_number: '1234567890'
                    routing_number: '123456789'
                    iban: null
                    currency: USD
                    balance:
                      available: 5000
                      current: 5000
                      pending: 0
                    account_details:
                      account_name: John Doe - Primary Checking
                      sort_code: null
                      bsb: null
                      swift: null
                    payment_rails:
                      incoming:
                        - ACH
                        - WIRE
                      outgoing:
                        - ACH
                        - WIRE
                    supports_book_transfers: true
                    created_at: '2026-02-01T10:10:00Z'
                    updated_at: '2026-02-01T12:00:00Z'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                      example: Request validation failed
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: VALIDATION_ERROR
                    messages:
                      - Request validation failed
          description: Solicitud incorrecta
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ACCOUNT_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Account not found
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: ACCOUNT_NOT_FOUND
                    messages:
                      - Account not found
          description: No encontrado
components:
  securitySchemes:
    public-api-key:
      type: apiKey
      in: header
      name: public-api-key
    private-secret-key:
      type: apiKey
      in: header
      name: private-secret-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.