Actualizar ajustes de canal
Aplica un patch a los ajustes de canal del STR. Solo se actualizan los campos provistos; los campos ausentes conservan su valor actual. Debe proveerse al menos un campo. Establecer el ISPB del participante requiere un valor explícito de 8 dígitos (se rechazan placeholders como 00000000). Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key (primary).
Idempotency key (legacy alias for X-Idempotency).
Idempotency key TTL in seconds (overrides the configured default).
Cuerpo
Optional notification delivery mode to set: WEBHOOK, EVENT (streaming), or BOTH; left unchanged when omitted.
"WEBHOOK"
Optional participant ISPB to set, the 8-digit BACEN institution identifier; left unchanged when omitted.
8^[0-9]{8}$"12345678"
Optional client-supplied settings metadata to merge; sensitive keys are redacted on read.
Respuesta
OK
SPB channel connectivity status: CONNECTED or PENDING_CONFIGURATION.
"CONNECTED"
Notification delivery mode: WEBHOOK, EVENT (streaming), or BOTH.
"WEBHOOK"
Participant ISPB the settings belong to, the 8-digit BACEN institution identifier.
8^[0-9]{8}$"12345678"
Configured webhook endpoints that receive STR notifications.
Whole days remaining until the active certificate expires; absent when no certificate is configured.
365
UTC RFC 3339 expiry timestamp of the active ICP-Brasil certificate; absent when no certificate is configured.
"2027-05-04T18:30:00Z"
Client-supplied settings metadata; sensitive keys and values are redacted before being returned.
Embedded readiness summary; present only when the readiness summary is available.

