Edit a hub subscription
Edits a subscription’s name, endpoint, event types, event majors, schema major and timeout; it keeps its id, secret, kind and origin. schema_major is required (null clears the pin); every other field is optional and only what is sent changes. A new endpoint moves an active subscription only after it answers a verification probe (422 destination_probe_failed, nothing changes). Send the ETag of a read as If-Match: another operator’s edit in between answers 412 subscription_changed; without If-Match the last write wins. A refusal keeps the hub’s status and carries the hub’s own code in upstream.code: branch on that code, not on the status.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Bearer token, relayed to the streaming-hub as server-to-server auth.
Idempotency key, forwarded to the hub's idempotency middleware, which refuses this mutation without one.
The ETag a read of the subscription returned. When the subscription changed since, the edit is refused 412 subscription_changed. Absent means the last write wins.
"\"1700000000123456\""
Parâmetros de caminho
Subscription id.
Corpo
Schema major to pin to, or null to clear the pin (follow base). Required on every edit.
2
New delivery destination, validated as at create. An active subscription moves only after the new destination answers a verification probe.
"https://hooks.example.com/ingest"
New schema major per event type, replacing the overrides; {} clears them. Omit to keep them.
New subscribed event types, replacing the list; ["*"] or [] means all events. Omit to keep them.
New subscription name. Omit to keep it.
"orders-webhook"
Per-attempt delivery timeout in milliseconds, 1000 to 20000, webhook subscriptions only; 0 gives it up. Omit to keep it.
20000
Resposta
OK

