Promote signing secret
Promote a next signing secret to current. Moov Money encrypts new ledger
requests with it from then on. The secret that was current becomes prior
and still decrypts responses until you revoke it.
The first secret for a receiver is current at creation, so it needs no
promotion. Create a replacement, load it into your ledger, then promote it.
Returns 204 when promoted, or when the secret is already current, so
retrying a promote is safe. Returns 400 when providerID or secretID is
malformed. Returns 403 when your account is not the receiver recorded on the
secret. A secret with no recorded receiver belongs to the FI. Returns 404
when the secret does not exist or belongs to another provider. Returns 409
when the secret is prior or is revoked.
Auth: API key or bearer token. Scoped to the calling provider. An affiliated
integrator needs the moov-money-config.write scope granted by the FI.
curl -X POST https://api.moov.money/providers/{providerID}/signing-secrets/{secretID}/promotions \
-u "$MOOV_API_KEY_ID:$MOOV_API_KEY_SECRET" \
-H "X-Moov-Version: v2026.10.00"Response body application/problem+json
application/problem+json.
From v2026.10.00, every error response that has a body uses this schema.type
string
requiredhttps://api.moov.money/errors#<code> (for
example invalid-request, idempotency-key-reused, or
idempotency-request-in-progress). Treat the value as
an opaque constant and do not fetch it. about:blank means the HTTP
status code says everything there is to know.title
string
requiredstatus
integer<int32>
requireddetail
stringinstance
stringerrors
array<object>Show child attributes
errors[]
pointer
string
requireddetail
string
requiredResponse body application/problem+json
application/problem+json.
From v2026.10.00, every error response that has a body uses this schema.type
string
requiredhttps://api.moov.money/errors#<code> (for
example invalid-request, idempotency-key-reused, or
idempotency-request-in-progress). Treat the value as
an opaque constant and do not fetch it. about:blank means the HTTP
status code says everything there is to know.title
string
requiredstatus
integer<int32>
requireddetail
stringinstance
stringerrors
array<object>Show child attributes
errors[]
pointer
string
requireddetail
string
requiredRetry-After.Response body application/problem+json
application/problem+json.
From v2026.10.00, every error response that has a body uses this schema.type
string
requiredhttps://api.moov.money/errors#<code> (for
example invalid-request, idempotency-key-reused, or
idempotency-request-in-progress). Treat the value as
an opaque constant and do not fetch it. about:blank means the HTTP
status code says everything there is to know.title
string
requiredstatus
integer<int32>
requireddetail
stringinstance
stringerrors
array<object>Show child attributes
errors[]
pointer
string
requireddetail
string
requiredHeaders
X-Moov-Version
stringv2026.10.00). When omitted, the server applies its default version.Path parameters
providerID
string
requiredsecretID
string
required