메인 콘텐츠로 건너뛰기

​
개요

이 엔드포인트는 기존 사용자 API 키의 이름, 사용 한도, 허용 모델, 만료, 상태를 업데이트할 때 사용합니다.

​
요청 본문

최소 1개 이상의 필드를 제공해야 합니다.
필드타입기본값 / 제한설명
statusenum-active, inactive, revoked
namestring길이 1-50업데이트된 표시 이름
limitAmountnumber | null최소 0, 입력 최대 1000000null = 무제한, 0 = 0 한도. 양수는 저장된 상한으로 정규화되며 USD 환산 기준 100000 을 넘지 않습니다
limitCurrencyenumdefault USDUSD만 지원됩니다. CNY를 보내면 400 currency_retired가 반환됩니다.
modelsstring[]-업데이트된 모델 허용 목록
expiresAtstring | nullRFC3339 datetimenull 은 만료 제거

​
참고 사항

  • Management API v1 에서는 하드 삭제를 의도적으로 지원하지 않습니다.
  • revoked 는 일반 운영에서 종료 상태로 취급되므로, 나중에 다시 살리는 흐름을 기대하기보다 새 키를 만드는 편이 낫습니다.

​
예시

curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

​
요청 / 응답

정확한 스키마와 응답 필드는 상단의 대화형 OpenAPI 패널을 참고하세요.

​
Response example

{
  "id": "key_abc123def456",
  "name": "Backend Worker",
  "key_prefix": "sk-live...",
  "status": "inactive",
  "limit_amount": 0,
  "limit_amount_decimal": "0",
  "used_amount": 148.25,
  "used_amount_decimal": "148.25",
  "models": [
    "gpt-5-mini",
    "claude-3-7-sonnet"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": "2026-07-08T03:12:45.000Z",
  "created_at": "2026-07-01T10:00:00.000Z"
}

​
Important fields

​
id
string
API key identifier used in follow-up Management API calls.
​
name
string
Display name for the API key.
​
key_prefix
string
Non-secret key prefix for display and support.
​
status
string
One of active, inactive, or revoked.
​
limit_amount
number | null
Spending cap in USD as a JSON number for display. null means unlimited.
​
limit_amount_decimal
string | null
Exact spending cap in USD as a decimal string. null means unlimited.
​
used_amount
number
Accumulated usage in USD as a JSON number for display.
​
used_amount_decimal
string
Exact accumulated usage in USD as a decimal string.
​
models
string[]
Per-key model allowlist. Empty array means no additional key-level model restriction.
​
expires_at
string | null
ISO timestamp when the key expires, or null for no expiry.
​
last_used_at
string | null
ISO timestamp for the most recent use, or null when unused.
​
created_at
string
ISO creation timestamp.