管理

APIキー一覧

現在の組織管理トークンに紐づくユーザー API キーを一覧表示します。

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

概要

現在の管理トークンに紐づく組織のユーザー API キー一覧を返します。

注意事項

  • 金額フィールドは USD のみをサポートします。

  • システム管理のキーは結果に含まれません。

例

pageintegerqueryデフォルト: 1
1 始まりのページ番号。
limitintegerqueryデフォルト: 50
1 ページあたり 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