> ## 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.

# Cancelar el onboarding de una entidad (Banking Connectivity)

> Cancela el onboarding de una entidad en curso con un proveedor de banking connectivity

> [!WARNING]
>
> Este endpoint aún no está disponible a través de la API pública. Las solicitudes a esta ruta devuelven 404 `NOT_FOUND`. El resto de esta página describe un comportamiento que hoy no está implementado.

Cancela un onboarding pendiente. Solo se pueden cancelar los onboardings que no han llegado a un estado terminal. Consulta [Estados de onboarding](https://docs.y.uno/es/reference/banking-connectivity.md#onboarding-statuses) para saber qué estados son terminales.


## OpenAPI

````yaml openapi/es/banking-connectivity/entity-onboarding-banking-connectivity/cancel-entity-onboarding.json POST /banking/entities/{entity_id}/onboardings/{onboarding_id}/cancel
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}/cancel:
    post:
      tags:
        - Entity Onboarding (Banking Connectivity)
      summary: Cancelar onboarding de entidad (Banking Connectivity)
      operationId: >-
        post_v1-banking-connectivity-entities-entity-id-onboardings-onboarding-id-cancel
      parameters:
        - in: path
          name: entity_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la entidad, que se obtiene de [Create
            Entity](/es/reference/banking-connectivity/entities-banking-connectivity/create-entity).
        - in: path
          name: onboarding_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la entidad, que se obtiene de [Create
            Entity](/es/reference/banking-connectivity/entities-banking-connectivity/create-entity).
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                OK:
                  summary: OK
                  value:
                    id: 990e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    provider:
                      name: example_bank
                      entity_id: col_entity_onboarded_123
                      status: cancelled
                    onboarding_type: ONE_STEP
                    status: CANCELLED
                    requirements: []
                    created_at: '2026-02-01T10:00:00Z'
                    updated_at: '2026-02-02T08:45:00Z'
                    expires_at: '2026-02-08T10:00:00Z'
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 990e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    example: 660e8400-e29b-41d4-a716-446655440000
                  account_id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
                  provider:
                    type: object
                    properties:
                      name:
                        type: string
                        description: El nombre del proveedor.
                        example: example_bank
                      entity_id:
                        type: string
                        example: col_entity_onboarded_123
                      status:
                        type: string
                        example: cancelled
                    description: >-
                      Los detalles del onboarding en el proveedor. Opcional: el
                      campo se omite cuando está vacío.
                  onboarding_type:
                    type: string
                    example: ONE_STEP
                  status:
                    type: string
                    example: CANCELLED
                  requirements:
                    type: array
                    items:
                      type: object
                      properties: {}
                    description: >-
                      Requisitos pendientes del onboarding. Opcional: el campo
                      se omite cuando está vacío.
                  created_at:
                    type: string
                    example: '2026-02-01T10:00:00Z'
                  updated_at:
                    type: string
                    example: '2026-02-02T08:45:00Z'
                  expires_at:
                    type: string
                    example: '2026-02-08T10:00:00Z'
                    description: >-
                      Cuándo vence el onboarding. Opcional: el campo se omite
                      cuando está vacío.
        '202':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 990e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    example: 660e8400-e29b-41d4-a716-446655440000
                  account_id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
                  provider:
                    type: object
                    properties:
                      name:
                        type: string
                        description: El nombre del proveedor.
                        example: example_bank
                      entity_id:
                        type: string
                        example: col_entity_onboarded_123
                      status:
                        type: string
                        example: cancelled
                    description: >-
                      Los detalles del onboarding en el proveedor. Opcional: el
                      campo se omite cuando está vacío.
                  onboarding_type:
                    type: string
                    example: ONE_STEP
                  status:
                    type: string
                    example: CANCELLED
                  requirements:
                    type: array
                    items:
                      type: object
                      properties: {}
                    description: >-
                      Requisitos pendientes del onboarding. Opcional: el campo
                      se omite cuando está vacío.
                  created_at:
                    type: string
                    example: '2026-02-01T10:00:00Z'
                  updated_at:
                    type: string
                    example: '2026-02-02T08:45:00Z'
                  expires_at:
                    type: string
                    example: '2026-02-08T10:00:00Z'
                    description: >-
                      Cuándo vence el onboarding. Opcional: el campo se omite
                      cuando está vacío.
          description: Aceptado
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                      example: >-
                        Onboarding has reached a terminal status and cannot be
                        cancelled
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: VALIDATION_ERROR
                    messages:
                      - >-
                        Onboarding has reached a terminal status and cannot be
                        cancelled
          description: Solicitud incorrecta
        '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.