Change a team key's cap or label — PATCH /v1/keys/team/{key_id}

Set, change or remove one team key's monthly credit cap, and/or relabel it. The key string does not change and nothing needs redeploying. `{"monthly_cap": 5000}` caps this key at 5,000 credits for the rest of this period — against the counter it has ALREADY spent, so lowering a cap below what a key has used this month refuses it until the 1st rather than rewriting history. `{"monthly_cap": null}` removes the cap and lets the key spend the whole pool. Leave a field out and it is not touched: `{"label": "Jo's laptop"}` alone renames the key and leaves its cap alone.

Requires X-API-Key 0 credits

Request

curl -X PATCH 'https://api.puntersedge.online/v1/keys/team/YOUR_KEY_ID' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "monthly_cap": 1}'

Parameters

Name	In	Type	Required	Description
`key_id`	path	string	yes	key_id from GET /v1/keys/team.
`label`	body	string	no	New label for this key. Omit to leave it alone.
`monthly_cap`	body	integer	no	Optional. The most credits THIS key may spend per month, hard, inside the account's shared pool — between 1 and the plan's own monthly allowance. Omit it (or send null) and the key may spend the whole pool. Caps reset with the pool on the 1st. Send null to REMOVE an existing cap; omit the field entirely to leave the cap as it is.

Responses

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

Example response

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

{
  "key_id": "0c9a52d1-6b34-47ef-8a2b-5d1e93c4f087",
  "key_hint": "41e8b2c5…",
  "label": "Staging",
  "plan": "pro_plus",
  "created_at": "2026-08-02T23:40:55Z",
  "last_used_at": "2026-09-24T21:58:02Z",
  "period_calls": 5120,
  "period_credits": 6180,
  "monthly_cap": 25000,
  "key_credits_used": 6180
}

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

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