billing

Roll (rotate) a key

Self-service: issues a new key and transitions the target key out of service — free plan revokes it instantly, starter/pro give it a grace period (default 24h; pro can configure up to 7 days via gracePeriodHours). The target key must belong to the caller's own account (a key may roll itself, or another key on the same account); otherwise 404 — this is exactly the 'I just leaked my key, roll it myself, one last time' path, and it never reveals whether a keyId belonging to a different account exists.

post/v1/keys/{keyId}/roll

Request

  • Base URL: https://modelglass-api.vercel.app
  • URL: https://modelglass-api.vercel.app/v1/keys/{keyId}/roll
  • Auth: HTTP bearer

Path parameters

keyIdstring required

Request body

gracePeriodHoursnumber

Pro/internal only; 400 on other tiers.

Response

New key issued; the target key is rolled.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.