Saltar al contenido principal
POST
Deshabilitar destino
Desactiva un destino sin quitarlo. El registro y su historial de auditoría se conservan, pero el proxy de reenvío 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.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Encabezados

X-Account-Code
string<uuid>

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.

Parámetros de ruta

id
string<uuid>
requerido

El id (UUID) del destino que se va a deshabilitar.

Ejemplo:

"d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4"

Respuesta

El destino se deshabilitó; se devuelve el objeto actualizado.

id
string<uuid>

Identificador único del destino. Úsalo para eliminar el destino.

Ejemplo:

"d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4"

account_id
string | null

La cuenta a la que está asociado este destino, o null cuando aplica a toda la organización.

Ejemplo:

null

hostname
string

El nombre de host registrado.

Ejemplo:

"api.example-processor.com"

status
enum<string>

Indica si el destino está activo. Solo los destinos ENABLED se usan en la ruta de reenvío.

Opciones disponibles:
ENABLED,
DISABLED
Ejemplo:

"ENABLED"

purpose
string

La etiqueta que proporcionaste al registrar el destino.

Ejemplo:

"Direct acquiring — Processor X"

created_at
string<date-time>

Cuándo se registró el destino.

Ejemplo:

"2026-07-09T13:05:36Z"

updated_at
string<date-time>

Cuándo se cambió el destino por última vez.

Ejemplo:

"2026-07-09T13:05:36Z"