Rotate the callback signing secret for an External Application
Rotate the app-level key that workflow dispatch callbacks are signed with. Distinct from the client secret. Returned once, stored only encrypted, and never cached for Idempotency-Key replay. Requires permission apps:manage.
404 if no such app. 409 if the app is deactivated — reviving a deactivated app by rotating a key is not a supported path.
The secret is shown once
The response carries the secret exactly once. Forge keeps only an encrypted copy of the callback signing secret, and it never stores this response for Idempotency-Key replay. A repeat with the same key and body answers200 with only the app’s data.id (id-only replay), without the secret, and does not run again — no second rotation happens. A lost secret cannot be recovered: rotate again.
An app you may not manage — one whose management home your grants do not cover — answers 404 resource_missing.Authorizations
Headers
1–255 printable ASCII characters (0x21–0x7E, no spaces), scoped to the calling credential. A repeat with the same key and request never runs the write again, a 5xx included: once the operation's permissions pass again it answers the identical status and body of the first response (Idempotent-Replayed: true, also sent as Idempotency-Replayed: true), unless the operation's own replay policy withholds it; a first response that was not stored (over 32 KiB, or carrying a one-time secret) answers its first status with only data.id (Idempotency-Replay-Disclosure: id-only) when it named one; otherwise 409 idempotency_result_unavailable; a repeat while the first is still running is 409 idempotency_key_in_flight, and the same key with a different request is 422 idempotency_key_reuse. Honoured for External App JWTs and platform and Personal keys; an External App's static companion key is not protected.
1 - 255Response
Callback signing secret rotated. Response includes the one-time callbackSigningSecret. A same-key repeat whose first response was not stored (over 32 KiB, or a one-time secret) answers this status with only data.id (IdOnlyReplay, Idempotency-Replay-Disclosure: id-only).

