TokenLab

관리

API 키 수정

현재 Workspace의 API 키를 수정합니다.

PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}

개요

기존 사용자 API 키의 이름, 사용 한도, 허용된 모델, 만료 일시 또는 상태를 수정하려면 이 엔드포인트를 사용하세요.

요청 본문

최소 하나의 필드를 제공해야 합니다.

필드타입기본값 / 제한설명
statusenum-active, inactive, revoked
namestring길이 1-50업데이트할 표시 이름
limitAmountnumber | string | null0–100000 USDnull은 무제한을 의미하며, 0은 지출을 방지합니다. 소수점 문자열은 소수점 이하 최대 6자리까지 지원합니다.
limitCurrencyenum기본값 USDUSD 전용입니다. CNY를 전송하면 400 currency_retired가 반환됩니다. 설정 시 limitAmount가 필수입니다.
modelsstring[]-업데이트할 모델 허용 목록
deliveryPolicystring | nullauto, verified, official, nullnull은 Workspace 전달 정책을 상속합니다.
expiresAtstring | nullRFC3339 일시null은 만료 일시를 삭제합니다

참고 사항

  • 금액 필드는 USD 전용입니다. CNY 입력은 지원 중단되었으며 400 currency_retired를 반환합니다.

  • Management API는 삭제 기능을 제공하지 않습니다. 일시 중지하려면 inactive를 사용하고, 키를 영구적으로 폐기하려면 revoked를 사용하세요.

  • 폐기된 키는 새 키로 교체해야 합니다. 폐기된 키를 active로 설정하면 409 api_key_revoked가 반환됩니다.

  • suspended는 응답에 나타날 수 있지만, 요청으로 전송할 수는 없습니다.

예시

요청

cURL
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을 사용하여 터미널 또는 클라이언트에서 관리 요청을 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.

응답 예시

응답

200 OK
{
  "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
}

주요 필드

idstring
후속 Management API 호출에 사용되는 API 키 식별자입니다.
namestring
API 키의 표시 이름입니다.
key_prefixstring
표시 및 지원용 비보안 키 접두사입니다.
statusstring
active, inactive, suspended, revoked 중 하나입니다.
limit_amountnumber | null
표시용 JSON 숫자 형식의 USD 기준 지출 한도입니다. null은 무제한을 의미합니다.
limit_amount_decimalstring | null
소수점 문자열 형식의 정확한 USD 기준 지출 한도입니다. null은 무제한을 의미합니다.
used_amountnumber
표시용 JSON 숫자 형식의 USD 기준 누적 사용량입니다.
used_amount_decimalstring
소수점 문자열 형식의 정확한 USD 기준 누적 사용량입니다.
modelsstring[]
키별 모델 허용 목록입니다. 빈 배열은 추가적인 키 수준 모델 제한이 없음을 의미합니다.
delivery_policystring | null
auto, verified, official, null. null은 Workspace 전달 정책을 상속합니다.
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