Atualizar configurações de canal
Aplica um patch às configurações de canal do STR. Somente os campos fornecidos são atualizados; os campos ausentes mantêm seu valor atual. Ao menos um campo deve ser fornecido. Definir o ISPB do participante exige um valor explícito de 8 dígitos (placeholders como 00000000 são rejeitados). Idempotente: reenviar a mesma chave X-Idempotency com o mesmo corpo retorna a resposta em cache.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Idempotency key (primary).
Idempotency key (legacy alias for X-Idempotency).
Idempotency key TTL in seconds (overrides the configured default).
Corpo
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.
Resposta
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.

