POST /v1/keys/rotate — Rotate your API key

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.

Requires X-API-Key

Request

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

Parameters

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.

Responses

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

Related endpoints

GET /v1/billing/portal — Self-service billing portal link
GET /v1/health — Connector health status
GET /v1/keys/info — API key metadata
POST /v1/keys/ip-whitelist — Set IP whitelist for your key
GET /v1/uptime — Public uptime stats
GET /v1/usage — Check API usage
GET /v1/usage/analytics — Usage breakdown by endpoint

Try it against live data

The free tier needs no credit card, and the sandbox endpoints need no key at all.

Get a free API key Quickstart