メインコンテンツへスキップ
GET /api/v1/forward/identities/{identity_id} 認証されたアカウントが所有する Identity を返します。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID。

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK
{
  "id": "idn_019eabc123",
  "external_id": "user_456",
  "name": "Example User",
  "enabled": true,
  "metadata": {
    "channel": "web"
  },
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:00:00Z"
}

Response fields

Identity オブジェクトを返します。

Errors

HTTPTypeTrigger
401authentication_errorPAT が無効または期限切れです。
403permission_errorこのリソースへのアクセス権がありません。
404not_found_errorIdentity が存在しないか、呼び出し元に表示されません。

Notes

  • 無効化されたアイデンティティも取得できます。
  • 削除されたアイデンティティを使用して新しいセッションを作成してはなりません。

アイデンティティを更新する

アイデンティティ構成一覧を取得する