Saltar al contenido principal
PUT
Establece o rota una credencial de cola

Autorizaciones

Authorization
string
header
requerido

Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva contexto de tenant.

Parámetros de ruta

id
string<uuid>
requerido

The unique identifier of the subscription (UUIDv7).

Cuerpo

application/json

The queue-credential body. sinkConfig is a kind-specific, write-only object that is probed and, on success, stored encrypted. It is never returned on any read path.

sinkConfig
object
requerido

The candidate outbound credential for the queue kind. For rabbitmq, an object such as {"uri":"amqps://user:pass@broker.example.com:5671/vhost"}; for AWS kinds, the region and access material. Write-only — never logged or returned.

Ejemplo:

Respuesta

La sonda se ejecutó; el cuerpo lleva el resultado clasificado. En caso de éxito la credencial se persistió y la suscripción está active; en un fallo clasificado no se persistió nada.

The classified result of a synchronous probe (ping, verify, or credential write). A classified failure is still returned with HTTP 200 — the probe ran and produced a verdict. It carries no secret, endpoint, or detail string.

outcome
enum<string>
requerido

The classified verdict of a synchronous probe.

Opciones disponibles:
ok,
failed
statusCode
integer
requerido

The target's protocol status. For webhook probes, the HTTP status (0 when none applies, e.g. a transport error or a blocked endpoint). For queue-kind credential probes, always 0.

Ejemplo:

200

errorClass
string
requerido

A frozen taxonomy token classifying a failure. Empty on success.

Ejemplo:

""