API キー管理

API キー作成

新しい API キーを作成します。フルキーの値はこのレスポンスでのみ返されます。

curl -X POST https://api.nanoterm.dev/api/keys \
  -H 'Authorization: Bearer nt_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "prod-coding-agent",
    "permission": "execute",
    "expiresInDays": 90
  }'

リクエストボディ:

フィールド	型	必須	デフォルト	説明
name	string	はい	—	人間が読める名前
permission	string	いいえ	execute	full、execute、read
expiresInDays	number	いいえ	無期限	有効日数（1〜365）

レスポンス: 201 Created

{
  "id": "key_a1b2c3d4",
  "orgId": "org_x1y2z3",
  "name": "prod-coding-agent",
  "key": "nt_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "prefix": "nt_a1b2c3d4e5f6...",
  "permission": "execute",
  "createdAt": "2026-04-06T08:00:00.000Z",
  "expiresAt": "2026-07-05T08:00:00.000Z",
  "lastUsedAt": null,
  "revokedAt": null
}

警告

key フィールドをすぐにコピーしてください。以降の API 呼び出しでは返されません。

API キー一覧

組織のすべてのキーを一覧表示します。フルキーの値は返されません。

curl https://api.nanoterm.dev/api/keys \
  -H 'Authorization: Bearer nt_xxx'

レスポンス: 200 OK — ApiKeyInfo の配列（key フィールドなし）

API キー無効化

キーを永久に無効化します。無効化後は認証に使用できません。

curl -X DELETE https://api.nanoterm.dev/api/keys/key_a1b2c3d4 \
  -H 'Authorization: Bearer nt_xxx'

レスポンス: 200 OK — revokedAt が設定されたキー情報