Identity が使用した Template と、その Session 統計を一覧表示します。
GET /api/v1/forward/identities/{identity_id}/agents
リクエストヘッダー
| Header | 必須 | 説明 |
|---|---|---|
Authorization | はい | Bearer <PAT または SAT> |
パスパラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
identity_id | string | はい | Forward Identity ID。 |
レスポンス例
HTTP 200 OK
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
data | array | Template の使用統計一覧。 |
data[].template_id | string | Forward Template ID。 |
data[].template_name | string | Template 名。 |
data[].session_count | integer | この Identity が Template を使用して作成した Session の数。 |
data[].last_active_at | string|null | 最終アクティブ時刻。RFC 3339 形式。 |
エラー
| HTTP | Type | Code | 発生条件 |
|---|---|---|---|
| 401 | authentication_error | authentication_required | PAT または SAT が無効、期限切れ、または指定されていません。 |
| 404 | not_found_error | - | Identity が存在しないか、呼び出し元から参照できません。 |