관리
API 키 수정
현재 Workspace의 API 키를 수정합니다.
개요
기존 사용자 API 키의 이름, 사용 한도, 허용된 모델, 만료 일시 또는 상태를 수정하려면 이 엔드포인트를 사용하세요.
요청 본문
최소 하나의 필드를 제공해야 합니다.
| 필드 | 타입 | 기본값 / 제한 | 설명 |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | 길이 1-50 | 업데이트할 표시 이름 |
limitAmount | number | string | null | 0–100000 USD | null은 무제한을 의미하며, 0은 지출을 방지합니다. 소수점 문자열은 소수점 이하 최대 6자리까지 지원합니다. |
limitCurrency | enum | 기본값 USD | USD 전용입니다. CNY를 전송하면 400 currency_retired가 반환됩니다. 설정 시 limitAmount가 필수입니다. |
models | string[] | - | 업데이트할 모델 허용 목록 |
deliveryPolicy | string | null | auto, verified, official, null | null은 Workspace 전달 정책을 상속합니다. |
expiresAt | string | null | RFC3339 일시 | null은 만료 일시를 삭제합니다 |
참고 사항
-
금액 필드는 USD 전용입니다.
CNY입력은 지원 중단되었으며400 currency_retired를 반환합니다. -
Management API는 삭제 기능을 제공하지 않습니다. 일시 중지하려면
inactive를 사용하고, 키를 영구적으로 폐기하려면revoked를 사용하세요. -
폐기된 키는 새 키로 교체해야 합니다. 폐기된 키를
active로 설정하면409 api_key_revoked가 반환됩니다. -
suspended는 응답에 나타날 수 있지만, 요청으로 전송할 수는 없습니다.
요청
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-sonnet-4-6"
],
"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
}주요 필드
active, inactive, suspended, revoked 중 하나입니다.null은 무제한을 의미합니다.null은 무제한을 의미합니다.auto, verified, official, null. null은 Workspace 전달 정책을 상속합니다.null입니다.null입니다.인증
ManagementTokenAuth 관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.
위치: header
경로 매개변수
요청 본문
application/json
최소 하나 이상의 필드가 제공되어야 합니다.
1 <= properties응답
application/json
application/json
application/json
application/json
application/json
application/json