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

# Deshabilitar destino

> Desactiva un destino sin quitarlo de la lista de permitidos de tu PCI Proxy.

Desactiva un destino sin quitarlo. El registro y su historial de auditoría se conservan, pero el [proxy de reenvío](https://docs.y.uno/es/reference/pci-proxy/invoke-forward-proxy.md) lo rechaza con `403 DESTINATION_NOT_ALLOWED` hasta que se vuelva a habilitar. Es útil para suspender un destino de forma temporal sin perder su configuración. Consulta la [guía de la lista de destinos permitidos](https://docs.y.uno/es/docs/security-and-compliance/pci-proxy/allowlist.md).


## OpenAPI

````yaml openapi/es/pci-proxy/manage-destinations.json POST /pci-proxy/destinations/{id}/disable
openapi: 3.1.0
info:
  title: pci-proxy-manage-destinations
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /pci-proxy/destinations/{id}/disable:
    post:
      summary: Deshabilitar destino
      description: >-
        Desactiva un destino sin eliminarlo: el registro y su historial de
        auditoría se conservan, pero la ruta de reenvío lo rechaza con `403
        DESTINATION_NOT_ALLOWED` hasta que se vuelva a habilitar.
      operationId: disablePciProxyDestination
      parameters:
        - name: id
          in: path
          required: true
          description: El `id` (UUID) del destino que se va a deshabilitar.
          schema:
            type: string
            format: uuid
            example: d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4
        - in: header
          name: X-Account-Code
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            Obligatorio si el destino se registró con un `account_id`: envía ese
            mismo `account_id`. Sin él, un destino asociado a una cuenta se
            trata como no encontrado.
      responses:
        '200':
          description: El destino se deshabilitó; se devuelve el objeto actualizado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Destination'
        '400':
          $ref: '#/components/responses/InvalidId'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/DestinationNotFound'
components:
  schemas:
    Destination:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Identificador único del destino. Úsalo para eliminar el destino.
          example: d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4
        account_id:
          type: string
          nullable: true
          description: >-
            La cuenta a la que está asociado este destino, o `null` cuando
            aplica a toda la organización.
          example: null
        hostname:
          type: string
          description: El nombre de host registrado.
          example: api.example-processor.com
        status:
          type: string
          enum:
            - ENABLED
            - DISABLED
          description: >-
            Indica si el destino está activo. Solo los destinos ENABLED se usan
            en la ruta de reenvío.
          example: ENABLED
        purpose:
          type: string
          description: La etiqueta que proporcionaste al registrar el destino.
          example: Direct acquiring — Processor X
        created_at:
          type: string
          format: date-time
          description: Cuándo se registró el destino.
          example: '2026-07-09T13:05:36Z'
        updated_at:
          type: string
          format: date-time
          description: Cuándo se cambió el destino por última vez.
          example: '2026-07-09T13:05:36Z'
    DestinationError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - NOT_AUTHENTICATED
            - AuthenticationFail
            - INVALID_REQUEST
            - INVALID_HOSTNAME
            - INVALID_ACCOUNT_ID
            - DESTINATION_EXISTS
            - NOT_FOUND
            - INTERNAL_ERROR
        messages:
          type: array
          items:
            type: string
  responses:
    InvalidId:
      description: El parámetro de ruta `id` no es un UUID válido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DestinationError'
          examples:
            Invalid id:
              value:
                code: INVALID_REQUEST
                messages:
                  - invalid id
    Unauthorized:
      description: Falló la autenticación. Faltan las credenciales de API o no son válidas.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DestinationError'
          examples:
            Not authenticated:
              value:
                code: NOT_AUTHENTICATED
                messages:
                  - not authenticated
    DestinationNotFound:
      description: No hay ningún destino con ese `id` registrado en tu ámbito.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DestinationError'
          examples:
            Not found:
              value:
                code: NOT_FOUND
                messages:
                  - destination not found
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

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