ディレクトリのトークンの作成
POST /v1/directories/{directory_id}/tokens · 権限 directories:write
ローテーション用に新しいSCIMトークンを発行します。ディレクトリが持てる有効なトークンは最大2つです。新しいトークンをIDプロバイダーに渡し、その後 DELETE /v1/directories/{directory_id}/tokens/{token_id} で古いトークンを失効させてください。token はこのレスポンスでのみ一度だけ返されます（Cache-Control: no-store）。同じ Idempotency-Key で再送されたレスポンスには含まれず、secret_redacted: true が付きます。空のオブジェクト（{}）を送ると既定値が使われます。作成は directory.token_created として監査されます。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
directory_id |
path | はい | SCIMディレクトリID（dir_…）。 |
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
label |
string | いいえ | 1〜100文字。既定値 Token。 |
expires_in_days |
integer | いいえ | 30〜730。既定値 365。 |
レスポンス
201 Created とトークンのメタデータ、一度限りの token を返します。
{
"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,
"token": "idp_scim_<token>"
}
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 404 | not_found |
ディレクトリがこの環境に存在しません。 |
| 409 | conflict |
ディレクトリにすでに有効なトークンが2つあります。先に1つを失効させてください。 |
| 422 | validation_failed |
label が空または長すぎる、または expires_in_days が30〜730の範囲外です。 |
| 401 | unauthenticated |
認証情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を待ってから再試行してください。 |
| 503 | service_unavailable |
ディレクトリ同期が一時的に利用できないか、このデプロイメントで構成されていません。Retry-After の期間を待ってから再試行してください。 |
例
curl -i -X POST "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/tokens" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"label":"rotation","expires_in_days":90}'