Management Key

API キーを一覧表示

呼び出し元が管理できる API キーを一覧表示します。組織の Management Key を使う場合は、そのキーが属する組織のキーだけを返し、所有者の個人キーや他組織のキーは決して含めません。通常の sk-bl- キーではこの管理エンドポイントを呼び出せません。Web ダッシュボードではログイン済みセッション Cookie も使えます。各 keys[] 要素には limit、limit_remaining、limit_reset、usage、usage_daily/weekly/monthly、requests、requests_daily/weekly/monthly、usage_scope: key が含まれます。値はそのキーで GET /v1/key を呼んだ場合と一致します。個別上限がある場合、limit_remaining はリセット期間の支出を引いた残りで、上限がない場合はそのキーが使う残高です。キーの秘密値は返しません。組織合計と各キーの使用量を続けて確認する例は GET /v1/key の Management Key 例を参照してください。

GET/v1/keys

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

クエリパラメータ

orgId

string

セッション Cookie では、呼び出し元がその組織の org_admin または billing_viewer である場合に組織 ID を指定して一覧表示できます。組織の Management Key は自分の組織に限定され、このパラメータで組織を切り替えることはできません。

GET /v1/keys

1
2
curl https://api.bazaarlink.ai/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

レスポンス例

成功。keys[] は新しい順で、各キーのメタデータと使用量を含み、秘密値は含みません。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "keys": [
    {
      "id": "key_demo_01",
      "name": "worker-a",
      "keyPrefix": "demo_",
      "keySuffix": "01",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 73,
      "totalTokens": 48200,
      "lastUsed": "2026-09-30T02:14:00.000Z",
      "createdAt": "2026-09-01T00:00:00.000Z",
      "spendLimitUsd": 10,
      "spendLimitPeriod": "day",
      "limit": 10,
      "limit_remaining": 7.88,
      "limit_reset": "day",
      "usage": 24.41,
      "usage_daily": 2.12,
      "usage_weekly": 5.64,
      "usage_monthly": 9.37,
      "requests": 314,
      "requests_daily": 18,
      "requests_weekly": 61,
      "requests_monthly": 205,
      "usage_scope": "key",
      "allowedModels": null,
      "expiresAt": null,
      "organizationId": "org_demo_01",
      "teamId": null,
      "orgMemberId": null
    }
  ]
}