Rotate your key

POST/api/partner/keys/rotate

Key scope: partner key · Success: 201

A new key, shown once. The old key keeps working for the overlap you choose, so you can deploy the new one without downtime, then end the overlap early or let it lapse. Only the current key can rotate. Event key.rotated.

Body

overlapHours integer: 0–72, default 24. 0 ends the old key at once.

Errors

400 overlap_invalid
409 key_not_current
409 key_unknown
409 key_changed
401 partner_key_required
401 partner_key_invalid
429 rate_limited
503 direct_deposit_disabled

All codes: Errors.

Request

curl -X POST "https://wallet.simpleeasytransactions.com/api/partner/keys/rotate" \
  -H "Authorization: Bearer $SET_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "overlapHours": 24 }'

Body

{ "overlapHours": 24 }

Response 201

{ "object": "partner_keys", "current": { "prefix": "set_partner_…", "issuedAt": "2026-11-08T15:04:05.000Z" }, "previous": { "prefix": "set_partner_…", "expiresAt": "2026-11-10T15:04:05.000Z" }, "key": "…",
  "message": "Shown once: store it now. Your previous key keeps working until 2026-11-10T15:04:05.000Z; end that sooner with POST /api/partner/keys/previous/revoke once you have deployed this one." }