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. Every console session on the account is signed out, and with immediate=true every login or password-reset link already emailed stops working too. From a signed-in console session this needs the account password (`{"password": ...}` in the body) or a sign-in from the last 30 minutes, as POST /v1/keys/reveal does; with the key itself it needs nothing more. Cost: 0 credits.
X-API-Key
curl -X POST 'https://api.puntersedge.online/v1/keys/rotate' \
-H 'X-API-Key: YOUR_KEY'
| Name | In | Type | Required | Description |
|---|---|---|---|---|
immediate |
query | boolean | no | Revoke the old key NOW instead of after the grace window. Use this when rotating because the key leaked — a grace window keeps a compromised credential alive and is the wrong default for that case. |
Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.
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."
}
GET /v1/account — Your account: email, plan, password, billing and consent statusGET /v1/account/events — Your account's change historyGET /v1/account/insights — Usage, request health, projection and upgrade advicePOST /v1/account/marketing — Turn promotional emails on or off for your accountGET /v1/account/onboarding — Your onboarding checklistPUT /v1/account/onboarding — Choose your onboarding use casePOST /v1/account/password — Set or change your account passwordGET /v1/account/samples/{kind} — A labelled sample of a plan-gated endpoint's responseThe free tier needs no credit card, and the sandbox endpoints need no key at all.
Get a free API key Quickstart