Rotate an API key with a zero-downtime overlap window
Issue a replacement key with the same label, tier, and permissions as the original, and schedule the original to expire in 24h so a running bot can swap keys without any downtime.
The new raw key is returned once in this response — store it immediately. The old key keeps authenticating until its overlap window closes, then auto-expires (401 KEY_EXPIRED).
The replacement counts against your per-account key limit while the old key is still in its overlap window.
Authorizations
Issue from /v1/keys (or admin-issued for enterprise tier).
Headers
Path Parameters
Response
Successful Response
Returned once on creation — the raw key is NOT stored.
Magic number (0..9223372036854775807) stamped on every order placed with this key that does not send its own magic. Give each bot its own key to tag its orders without code changes.
Bot label (max 32 printable characters) stamped on every order placed with this key that does not send its own magic_label.