POST /v1/keys/team

Mint another key on this account. It shares this account's monthly credit pool and plan, has its own rate-limit bucket, its own IP whitelist and its own line in the usage breakdown, and can be revoked on its own. Business accounts may hold 3 keys in total, Platform 5, Scale 10 — the primary key counts as one. Pass `monthly_cap` to limit what this one key may spend per month inside the pool — the key refuses with 402 at its cap and the pool is not touched, so one client, one worker or one trial cannot spend the account's month. Change or remove it later with `PATCH /v1/keys/team/{key_id}`. Caps reset with the pool on the 1st. The key is returned once. It is stored hashed, like every key here, so if it is lost the answer is revoke and mint again, not recovery.

Request

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

Parameters

Responses

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

Example response

201 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",
  "api_key": "pe_4f9c2a7e1b8d3c6a5e0f7b2d9c4a1e8f",
  "label": "Staging",
  "plan": "pro_plus",
  "allowance": 3,
  "keys_in_use": 2,
  "pool_credits_limit": 300000,
  "pool_credits_used": 221110,
  "monthly_cap": 25000,
  "max_monthly_cap": 300000
}

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