POST /v1/keys/rotate

Issue a new API key. The old key keeps working for a short grace window so a multi-process caller can roll over without an outage; pass immediate=true to kill it now. Cost: 0 credits.

Request

curl -X POST 'https://api.puntersedge.online/v1/keys/rotate' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "new_key": "pe_4f9c2a7e1b8d3c6a5e0f7b2d9c4a1e8f",
  "old_key_hint": "pe_9b21c0…",
  "key_version": 2,
  "rotated_at": "2026-09-07T00:52:10Z",
  "previous_key_valid_until": "2026-09-08T00:52:10Z",
  "message": "Key rotated. The previous key keeps working for 24h (until previous_key_valid_until) so you can roll over without downtime. Re-run with immediate=true if the old key may have leaked."
}

Related endpoints

• GET /v1/account — Your account: email, plan, password, billing and consent status
• POST /v1/account/marketing — Turn promotional emails on or off for your account
• POST /v1/account/password — Set or change your account password
• GET /v1/billing/overage — Overage: state, rate and ceiling
• POST /v1/billing/overage — Switch overage on or off
• GET /v1/billing/portal — Self-service billing portal link
• POST /v1/billing/portal — Billing portal link (console; confirms your password)
• GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page