> ## 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 onboarding de entidad

> Envía documentación adicional para el onboarding de una entidad existente

Envía documentos adicionales para un onboarding existente. Normalmente se usa cuando el onboarding está en estado `PENDING_ADDITIONAL_DOCUMENTATION`. Solo se pueden actualizar los onboardings que no han llegado a un estado terminal; de lo contrario, la API devuelve 400 `INVALID_STATE_TRANSITION`.


## OpenAPI

````yaml openapi/es/banking-connectivity/entity-onboarding-banking-connectivity/update-entity-onboarding.json PATCH /banking/entities/{entity_id}/onboardings/{onboarding_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/entities/{entity_id}/onboardings/{onboarding_id}:
    patch:
      tags:
        - Entity Onboarding (Banking Connectivity)
      summary: Update Entity Onboarding (Banking Connectivity)
      operationId: >-
        patch_v1-banking-connectivity-entities-entity-id-onboardings-onboarding-id
      parameters:
        - in: path
          name: entity_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la entidad obtenido de [Create
            Entity](https://temp-yuno-docs.readme.io/reference/create-entity).
        - in: path
          name: onboarding_id
          schema:
            type: string
          required: true
          description: >-
            El `id` del onboarding obtenido de [Create Entity
            Onboarding](https://temp-yuno-docs.readme.io/reference/create-entity-onboarding).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - documentation
              description: >-
                Envía documentos para un onboarding que no ha alcanzado un
                estado terminal. Las declaraciones de cumplimiento, la
                evaluación de riesgo y el origen de los fondos no se pueden
                actualizar a través de este endpoint.
              properties:
                account_id:
                  type: string
                  description: >-
                    El identificador único de la cuenta de Yuno del comercio
                    (UUID, 36 caracteres).
                  example: 550e8400-e29b-41d4-a716-446655440000
                documentation:
                  type: array
                  description: >-
                    Los documentos que se enviarán. Se requiere al menos un
                    elemento. Cada elemento tiene un `document_type` y un
                    subobjeto con su mismo nombre, que contiene el arreglo
                    `files`. Las fechas usan `YYYY-MM-DD`.
                  items:
                    type: object
                    required:
                      - document_type
                    properties:
                      document_type:
                        type: string
                        description: >-
                          El tipo de documento. Selecciona el subobjeto que
                          debes enviar con el mismo nombre en minúsculas, por
                          ejemplo `BANK_STATEMENT` requiere `bank_statement`.
                        example: BANK_STATEMENT
                        enum:
                          - IDENTITY_DOCUMENT
                          - PROOF_OF_ADDRESS
                          - BANK_STATEMENT
                          - TAX_INFORMATION
                          - BIOMETRIC_VERIFICATION
                          - EMPLOYMENT_INFORMATION
                          - BUSINESS_DOCUMENT
                          - FINANCIAL_DOCUMENT
                      identity_document:
                        type: object
                        required:
                          - document_number
                          - issuing_country
                          - files
                        properties:
                          document_number:
                            type: string
                            description: El número del documento.
                            example: D1234567
                          document_subtype:
                            type: string
                            description: El subtipo del documento.
                            example: DRIVERS_LICENSE
                          issuing_country:
                            type: string
                            description: El país emisor (ISO 3166-1 alpha-2).
                            example: US
                          expires_at:
                            type: string
                            description: La fecha de vencimiento. Formato `YYYY-MM-DD`.
                            example: '2028-01-15'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      proof_of_address:
                        type: object
                        required:
                          - issuing_country
                          - files
                        properties:
                          issuing_country:
                            type: string
                            description: El país emisor (ISO 3166-1 alpha-2).
                            example: US
                          issued_at:
                            type: string
                            description: La fecha de emisión. Formato `YYYY-MM-DD`.
                            example: '2026-01-01'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      bank_statement:
                        type: object
                        required:
                          - files
                        properties:
                          bank_name:
                            type: string
                            description: El nombre del banco.
                            example: Chase Bank
                          account_number_last_4:
                            type: string
                            description: >-
                              Los últimos 4 caracteres del número de cuenta.
                              Deben ser exactamente 4 caracteres.
                            example: '1234'
                          period_start_at:
                            type: string
                            description: >-
                              El inicio del período del extracto. Formato
                              `YYYY-MM-DD`.
                            example: '2025-12-01'
                          period_end_at:
                            type: string
                            description: >-
                              El fin del período del extracto. Formato
                              `YYYY-MM-DD`.
                            example: '2025-12-31'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      tax_information:
                        type: object
                        required:
                          - tax_records
                        properties:
                          tax_records:
                            type: array
                            minItems: 1
                            items:
                              type: object
                              required:
                                - tax_number_type
                                - tax_number
                                - country
                              properties:
                                tax_number_type:
                                  type: string
                                  description: El tipo de número fiscal.
                                  example: SSN
                                  enum:
                                    - SSN
                                    - EIN
                                    - ITIN
                                    - ABN
                                    - NINO
                                    - NIF
                                    - OTHER
                                tax_number:
                                  type: string
                                  description: El número fiscal.
                                  example: 123-45-6789
                                country:
                                  type: string
                                  description: El país (ISO 3166-1 alpha-2).
                                  example: US
                                is_primary:
                                  type: boolean
                                  example: true
                      biometric_verification:
                        type: object
                        required:
                          - verification_type
                          - files
                        properties:
                          verification_type:
                            type: string
                            description: El tipo de verificación.
                            example: FACE_MATCH
                          confidence_score:
                            type: number
                            minimum: 0
                            maximum: 1
                            description: Un número decimal entre 0.0 y 1.0.
                            example: 0.98
                          verified_at:
                            type: string
                            description: La fecha de verificación. Formato `YYYY-MM-DD`.
                            example: '2026-01-20'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      employment_information:
                        type: object
                        required:
                          - files
                        properties:
                          employer_name:
                            type: string
                            description: El nombre del empleador.
                            example: Acme Corp
                          job_title:
                            type: string
                            description: El cargo.
                            example: Software Engineer
                          started_at:
                            type: string
                            description: La fecha de inicio. Formato `YYYY-MM-DD`.
                            example: '2020-03-01'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      business_document:
                        type: object
                        required:
                          - subtype
                          - files
                        properties:
                          subtype:
                            type: string
                            description: El subtipo de documento comercial.
                            example: ARTICLES_OF_INCORPORATION
                            enum:
                              - ARTICLES_OF_INCORPORATION
                              - BUSINESS_LICENSE
                              - EIN_CONFIRMATION
                              - OPERATING_AGREEMENT
                              - CERTIFICATE_OF_GOOD_STANDING
                          registration_number:
                            type: string
                            description: El número de registro.
                            example: REG-123456
                          registered_at:
                            type: string
                            description: La fecha de registro. Formato `YYYY-MM-DD`.
                            example: '2018-05-10'
                          issuing_state:
                            type: string
                            description: El estado emisor.
                            example: DE
                          issuing_authority:
                            type: string
                            description: La autoridad emisora.
                            example: Delaware Secretary of State
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      financial_document:
                        type: object
                        required:
                          - subtype
                          - files
                        properties:
                          subtype:
                            type: string
                            description: El subtipo de documento financiero.
                            example: BALANCE_SHEET
                            enum:
                              - BALANCE_SHEET
                              - PROFIT_LOSS_STATEMENT
                              - CASH_FLOW_STATEMENT
                              - FINANCIAL_AUDIT
                          period_start_at:
                            type: string
                            description: El inicio del período. Formato `YYYY-MM-DD`.
                            example: '2025-01-01'
                          period_end_at:
                            type: string
                            description: El fin del período. Formato `YYYY-MM-DD`.
                            example: '2025-12-31'
                          fiscal_year:
                            type: integer
                            example: 2025
                          audited:
                            type: boolean
                            example: true
                          auditor_name:
                            type: string
                            description: El nombre del auditor.
                            example: Example Audit LLP
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                  minItems: 1
            examples:
              Update Onboarding:
                summary: Update Onboarding
                value:
                  account_id: 550e8400-e29b-41d4-a716-446655440000
                  documentation:
                    - document_type: IDENTITY_DOCUMENT
                      identity_document:
                        document_number: D1234567
                        document_subtype: DRIVERS_LICENSE
                        issuing_country: US
                        expires_at: '2028-01-15'
                        files:
                          - file_name: license_front.jpg
                            content_type: image/jpeg
                            content: base64_encoded_content
                          - file_name: license_back.jpg
                            content_type: image/jpeg
                            content: base64_encoded_content
                    - document_type: BANK_STATEMENT
                      bank_statement:
                        bank_name: Chase Bank
                        account_number_last_4: '1234'
                        period_start_at: '2025-12-01'
                        period_end_at: '2025-12-31'
                        files:
                          - file_name: bank_statement_dec_2025.pdf
                            content_type: application/pdf
                            content: base64_encoded_content
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                OK:
                  summary: OK
                  value:
                    id: 990e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    status: PENDING
                    provider_status: verification_pending
                    requirements: []
                    updated_at: '2026-02-01T10:05:00Z'
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 990e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    example: 660e8400-e29b-41d4-a716-446655440000
                  status:
                    type: string
                    example: PENDING
                  provider_status:
                    type: string
                    example: verification_pending
                  requirements:
                    type: array
                    items:
                      type: object
                      properties: {}
                  updated_at:
                    type: string
                    example: '2026-02-01T10:05:00Z'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_PARAMETERS
                  messages:
                    type: array
                    items:
                      type: string
                      example: The field 'documentation[0].document_type' is required.
              examples:
                Invalid documentation:
                  summary: Invalid documentation
                  value:
                    code: INVALID_PARAMETERS
                    messages:
                      - The field 'documentation[0].document_type' is required.
                Terminal status:
                  summary: Terminal status
                  value:
                    code: INVALID_STATE_TRANSITION
                    messages:
                      - Cannot transition from SUCCEEDED to PENDING.
          description: >-
            Solicitud incorrecta. Se devuelve cuando a un documento le falta un
            campo obligatorio o tiene un valor no válido (`INVALID_PARAMETERS`),
            y cuando el onboarding ya tiene un estado terminal como `SUCCEEDED`
            (`INVALID_STATE_TRANSITION`).
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ONBOARDING_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Onboarding not found
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: ONBOARDING_NOT_FOUND
                    messages:
                      - Onboarding 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.