TokenLab

관리

API 키 목록

현재 조직 관리 토큰에 연결된 사용자 API 키를 나열합니다.

GEThttps://api.tokenlab.sh/v1/management/api-keys

개요

현재 관리 토큰에 연결된 조직의 사용자 API 키 목록을 반환합니다.

주의 사항

  • 금액 필드는 USD만 지원합니다.

  • 시스템 관리 key는 결과에 포함되지 않습니다.

예시

pageintegerquery기본값: 1
1부터 시작하는 페이지 번호입니다.
limitintegerquery기본값: 50
페이지당 1–100개입니다.

요청

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

요청 / 응답

이 페이지는 OpenAPI 스키마와 복사 가능한 요청 예제를 제공합니다. 관리 요청은 Management Token을 사용해 터미널이나 클라이언트에서 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.

응답 예시

응답

200 OK
{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-live...",
      "status": "active",
      "limit_amount": 500,
      "limit_amount_decimal": "500",
      "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
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

주요 필드

objectstring
항상 list입니다.
dataarray
API 키 객체 배열입니다.
paginationobject
page, limit, total, totalPages를 포함하는 페이지네이션 메타데이터입니다.
data[].idstring
후속 Management API 호출에 사용하는 API 키 식별자입니다.
data[].namestring
API 키의 표시 이름입니다.
data[].key_prefixstring
표시 및 지원에 사용하는 비밀이 아닌 키 접두사입니다.
data[].statusstring
active, inactive, suspended, revoked 중 하나입니다.
data[].limit_amountnumber | null
표시용 JSON 숫자로 반환되는 USD 지출 한도입니다. null은 무제한을 의미합니다.
data[].limit_amount_decimalstring | null
10진 문자열로 반환되는 정확한 USD 지출 한도입니다. null은 무제한을 의미합니다.
data[].used_amountnumber
표시용 JSON 숫자로 반환되는 USD 누적 사용 금액입니다.
data[].used_amount_decimalstring
10진 문자열로 반환되는 정확한 USD 누적 사용 금액입니다.
data[].modelsstring[]
키별 모델 허용 목록입니다. 빈 배열은 추가적인 키 수준 모델 제한이 없음을 의미합니다.
data[].delivery_policystring | null
auto, verified, official, null. null은 워크스페이스의 전달 정책을 상속합니다.
data[].expires_atstring | null
키 만료 시각의 ISO 타임스탬프이며, 만료되지 않으면 null입니다.
data[].last_used_atstring | null
가장 최근 사용 시각의 ISO 타임스탬프이며, 사용한 적이 없으면 null입니다.
data[].created_atstring
생성 시각의 ISO 타임스탬프입니다.

인증

ManagementTokenAuth
AuthorizationBearer <token>

관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.

위치: header

응답

application/json

application/json

application/json