メインコンテンツへスキップ

​
エンティティ詳細取得

指定したエンティティの詳細情報を返します。リンクされたエージェント実行、他のエンティティとのリレーションシップ、メタデータを含みます。

​
リクエスト

GET /api/v1/graph/entity/{entityId}

​
パスパラメータ

パラメータ型説明
entityIdstringエンティティ ID

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer snorbe_... 形式の API キー
ワークスペースは API キーに紐づくものが自動的に使用されます。workspaceId パラメータは不要です。

​
レスポンス

{
  "id": "clxxx001",
  "label": "Lithium-Ion Battery",
  "category": "technology",
  "kind": "entity",
  "description": "A type of rechargeable battery...",
  "metadata": {
    "url": { "value": "https://example.com/battery", "type": "text" }
  },
  "communityId": 3,
  "pagerank": 0.045,
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-03-20T14:22:00.000Z",
  "linkedEntities": [
    {
      "id": "clxxx002",
      "label": "Solid-State Electrolyte",
      "category": "technology",
      "kind": "material",
      "relationships": [
        { "direction": "outgoing", "type": "related_to", "weight": 0.85 }
      ]
    }
  ],
  "agentRuns": [
    {
      "id": "clrun001",
      "status": "completed",
      "process": [],
      "createdAt": "2026-04-01T09:00:00.000Z",
      "updatedAt": "2026-04-01T09:05:00.000Z",
      "agentId": "clagent001",
      "agentName": "research-agent",
      "linkedSources": [
        {
          "id": "clsrc001",
          "url": "https://example.com/paper",
          "title": "Research Paper",
          "sourceType": "public"
        }
      ],
      "linkedEntityIds": ["clxxx001", "clxxx002"],
      "linkedEntities": [
        {
          "id": "clxxx002",
          "label": "Solid-State Electrolyte",
          "category": "technology",
          "kind": "material"
        }
      ]
    }
  ]
}
エンティティがワークスペースに存在しない場合は null を返します。

​
レスポンスフィールド

フィールド型説明
idstringエンティティ ID
labelstringエンティティ名
categorystringカテゴリ（例: technology, company）
kindstringノード種別（entity, ghost）
descriptionstringエンティティの説明
metadataobject | nullエンティティに付与されたキーバリュー形式のメタデータ。各値は value（文字列）と type（文字列）フィールドを持つ
communityIdnumberコミュニティクラスタ ID
pageranknumberPageRank スコア
createdAtstring作成日時（ISO 8601）
updatedAtstring更新日時（ISO 8601）
linkedEntitiesobject[]グラフエッジで直接接続されているエンティティの配列
linkedEntities[].idstringリンク先エンティティ ID
linkedEntities[].labelstringリンク先エンティティ名
linkedEntities[].categorystringリンク先エンティティのカテゴリ
linkedEntities[].kindstringリンク先エンティティの種別
linkedEntities[].relationshipsobject[]2つのエンティティ間のリレーションシップ記述子
linkedEntities[].relationships[].directionstringエッジの方向（outgoing または incoming）
linkedEntities[].relationships[].typestringリレーションシップタイプ（例: related_to）
linkedEntities[].relationships[].weightnumberエッジの重み（0〜1）
agentRunsobject[]このエンティティにリンクされたエージェント実行
agentRuns[].idstringエージェント実行 ID
agentRuns[].statusstring実行ステータス（completed, running, error 等）
agentRuns[].processobject[]エージェント実行のプロセスイベント配列
agentRuns[].createdAtstring実行の作成日時（ISO 8601）
agentRuns[].updatedAtstring実行の更新日時（ISO 8601）
agentRuns[].agentIdstringこの実行を行ったエージェント ID
agentRuns[].agentNamestringエージェント名
agentRuns[].linkedSourcesobject[]このエージェント実行で使用されたソース
agentRuns[].linkedSources[].idstringソース ID
agentRuns[].linkedSources[].urlstringソース URL
agentRuns[].linkedSources[].titlestringソースタイトル
agentRuns[].linkedSources[].sourceTypestringソース種別（public または private）
agentRuns[].linkedEntityIdsstring[]このエージェント実行にリンクされたエンティティ ID
agentRuns[].linkedEntitiesobject[]このエージェント実行にリンクされたエンティティのサマリー
agentRuns[].linkedEntities[].idstringエンティティ ID
agentRuns[].linkedEntities[].labelstringエンティティ名
agentRuns[].linkedEntities[].categorystringエンティティカテゴリ
agentRuns[].linkedEntities[].kindstringエンティティ種別
各エージェント実行の process フィールドは、プロセスイベントの配列です。イベントタイプとペイロードの完全な一覧は、SSE ストリーミングのドキュメントを参照してください。

​
使用例

curl "https://app.snorbe.deskrex.ai/api/v1/graph/entity/clxxx001" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

​
エラーレスポンス

HTTP ステータス説明
401API キーが無効、期限切れ、または未指定
404エンティティが見つかりません（null ボディを返します）