ディレクトリのトークンの一覧

GET /v1/directories/{directory_id}/tokens · 権限 directories:write

ディレクトリのSCIMトークンのメタデータを新しい順に一覧します。失効済みと期限切れのトークンも含みますが、トークン本体やそのダイジェストは決して返しません。前方へのページングのみ対応し、カーソルはディレクトリに紐づきます。トークンの一覧表示には directories:write が必要です。

リクエスト

フィールド 型 必須 説明
directory_id path はい SCIMディレクトリID（dir_…）。
limit query いいえ 1〜100、既定値 20。
after query いいえ list_metadata.after のカーソル。

リクエストボディはありません。

レスポンス

200 OK とトークンのメタデータのページを返します。

{
  "data": [
    {
      "id": "0192a3b5-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
      "label": "rotation",
      "created_at": "2026-10-19T09:40:00.123456Z",
      "expires_at": "2027-01-17T09:40:00.123456Z",
      "revoked_at": null,
      "last_used_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

エラー

HTTP code 発生条件
400 invalid_cursor カーソルが無効、または別のディレクトリもしくはフィルターのものです。
404 not_found ディレクトリがこの環境に存在しません。
422 validation_failed limit が範囲外、または before か order が指定されました（unsupported）。
401 unauthenticated 認証情報がない、無効、または失効しています。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間を待ってから再試行してください。
503 service_unavailable ディレクトリ同期が一時的に利用できないか、このデプロイメントで構成されていません。Retry-After の期間を待ってから再試行してください。

例

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/tokens" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"