API キーを作成

新しい標準 API キー(または別の管理キー)を作成します。管理エンドポイントです。Bearer トークンで認証する場合、それは Management API Key である必要があり、通常の sk-bl- キーでは呼び出せません。ログイン済みのセッション Cookie でも動作します。レスポンス内の key フィールドが生のキー値を確認できる唯一の機会です——以降はハッシュのみが保存され、二度と取得できません。

POST/api/v1/keys

認証

Authorization必須

string · header

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

Body

name必須

string

キーの表示名。前後の空白は自動的に削除され、結果が空文字列であってはなりません。

≤200 chars, trimmed non-empty

keyType

string

キーの種類。デフォルトは standard。"management" 以外の値はすべて standard として扱われます。

standardmanagement

Example: "standard"

limit

number | null

支出上限(米ドル)。spendLimitUsd として保存されます。null または省略は上限なしを意味します。設定する場合は limit_reset も必ず指定してください。GET /v1/key はこの値を limit フィールドとして返します。

0–1,000,000

limit_reset

string | null

支出上限のリセット周期。spendLimitPeriod として保存されます。OR 互換のエイリアス(daily/weekly/monthly)、または内部名(day/week/month)のどちらでも受け付け、両方とも同じ効果です。

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

キーの有効期限。未来の時刻である必要がある ISO 日付文字列。null または省略は無期限を意味します。

Example: "2027-01-01T00:00:00Z"

organizationId

string | null

個人アカウントではなく指定した組織にキーを紐付けます。呼び出し元はその組織/チーム/メンバー範囲の認可チェックに合格する必要があり、そうでない場合は 400 を返します。

teamId

string | null

組織内の特定のチームにキーをさらに絞り込みます。organizationId と併用します。

orgMemberId

string | null

組織内の特定のメンバーにキーをさらに絞り込みます。organizationId と併用します。

POST /api/v1/keys

1
2
3
4
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "limit": 50, "limit_reset": "monthly"}'

レスポンス例

作成成功。key フィールドは完全な生の値で、この 1 回のレスポンスにのみ表示されます——直ちに保存してください。呼び出し元であっても以降は二度と取得できません。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "id": "key_abc123",
  "name": "production",
  "key": "sk-bl-AbCdEfGh...",
  "keyType": "standard",
  "prefix": "sk-bl-",
  "enabled": true,
  "spendLimitUsd": 50,
  "spendLimitPeriod": "month",
  "expiresAt": null,
  "createdAt": "2026-07-27T00:00:00.000Z",
  "organizationId": null,
  "teamId": null,
  "orgMemberId": null
}