관리
API 키 업데이트
현재 조직의 기존 사용자 API 키를 업데이트합니다.
PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}
개요
이 엔드포인트는 기존 사용자 API 키의 이름, 사용 한도, 허용 모델, 만료, 상태를 업데이트할 때 사용합니다.
요청 본문
최소 1개 이상의 필드를 제공해야 합니다.
| 필드 | 타입 | 기본값 / 제한 | 설명 |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | 길이 1-50 | 업데이트된 표시 이름 |
limitAmount | number | string | null | 0–100000 USD | null은 무제한, 0은 지출 불가입니다. 10진 문자열은 소수점 아래 6자리까지 지원합니다. |
limitCurrency | enum | 기본값 USD | USD만 지원됩니다. CNY를 보내면 400 currency_retired가 반환됩니다. 지정하면 limitAmount도 필요합니다. |
models | string[] | - | 업데이트된 모델 허용 목록 |
deliveryPolicy | string | null | auto, verified, official, null | null은 워크스페이스의 전달 정책을 상속합니다. |
expiresAt | string | null | RFC3339 datetime | null 은 만료 제거 |
참고 사항
-
금액 필드는 USD만 지원합니다.
CNY입력은 지원이 종료되었으며400 currency_retired가 반환됩니다. -
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 스키마와 복사 가능한 요청 예제를 제공합니다. 관리 요청은 Management Token을 사용해 터미널이나 클라이언트에서 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.
응답
{
"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.6-luna",
"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",
"delivery_policy": null
}주요 필드
idstring
후속 Management API 호출에 사용하는 API 키 식별자입니다.
namestring
API 키의 표시 이름입니다.
key_prefixstring
표시 및 지원에 사용하는 비밀이 아닌 키 접두사입니다.
statusstring
active, inactive, suspended, revoked 중 하나입니다.limit_amountnumber | null
표시용 JSON 숫자로 반환되는 USD 지출 한도입니다.
null은 무제한을 의미합니다.limit_amount_decimalstring | null
10진 문자열로 반환되는 정확한 USD 지출 한도입니다.
null은 무제한을 의미합니다.used_amountnumber
표시용 JSON 숫자로 반환되는 USD 누적 사용 금액입니다.
used_amount_decimalstring
10진 문자열로 반환되는 정확한 USD 누적 사용 금액입니다.
modelsstring[]
키별 모델 허용 목록입니다. 빈 배열은 추가적인 키 수준 모델 제한이 없음을 의미합니다.
delivery_policystring | null
auto, verified, official, null. null은 워크스페이스의 전달 정책을 상속합니다.expires_atstring | null
키 만료 시각의 ISO 타임스탬프이며, 만료되지 않으면
null입니다.last_used_atstring | null
가장 최근 사용 시각의 ISO 타임스탬프이며, 사용한 적이 없으면
null입니다.created_atstring
생성 시각의 ISO 타임스탬프입니다.
인증
ManagementTokenAuth AuthorizationBearer <token>
관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.
위치: header
경로 매개변수
keyId*string
요청 본문
application/json
최소 하나 이상의 필드가 제공되어야 합니다.
속성
1 <= properties응답
application/json
application/json
application/json
application/json
application/json
application/json