管理

APIキーの一覧取得

現在の組織管理トークンに対して、ユーザーが管理するAPIキーの一覧を取得します。

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

概要

現在の管理トークンに関連付けられた組織内のユーザーAPIキーを返します。

注意事項

  • 金額フィールドはUSDのみです。

  • システム管理のキーは除外されます。

例

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-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
    }
  ],
  "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
表示用のUSDでの利用上限額(JSON数値)。null は無制限を意味します。
data[].limit_amount_decimalstring | null
10進数文字列としての正確なUSD利用上限額。null は無制限を意味します。
data[].used_amountnumber
表示用のUSDでの累積利用額(JSON数値)。
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