> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# エンティティ詳細取得
> 指定したエンティティの詳細情報（リンクされたエージェント実行やリレーションシップを含む）を取得します
# エンティティ詳細取得
指定したエンティティの詳細情報を返します。リンクされたエージェント実行、他のエンティティとのリレーションシップ、メタデータを含みます。
## リクエスト
```
GET /api/v1/graph/entity/{entityId}
```
### パスパラメータ
| パラメータ | 型 | 説明 |
| ---------- | -------- | --------- |
| `entityId` | `string` | エンティティ ID |
### ヘッダー
| ヘッダー | 必須 | 説明 |
| --------------- | -- | ------------------------------ |
| `Authorization` | はい | `Bearer snorbe_...` 形式の API キー |
ワークスペースは API キーに紐づくものが自動的に使用されます。`workspaceId` パラメータは不要です。
## レスポンス
```json theme={null}
{
"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` を返します。
### レスポンスフィールド
| フィールド | 型 | 説明 |
| -------------------------------------------- | ---------------- | ---------------------------------------------------------------- |
| `id` | `string` | エンティティ ID |
| `label` | `string` | エンティティ名 |
| `category` | `string` | カテゴリ（例: `technology`, `company`） |
| `kind` | `string` | ノード種別（`entity`, `ghost`） |
| `description` | `string` | エンティティの説明 |
| `metadata` | `object \| null` | エンティティに付与されたキーバリュー形式のメタデータ。各値は `value`（文字列）と `type`（文字列）フィールドを持つ |
| `communityId` | `number` | コミュニティクラスタ ID |
| `pagerank` | `number` | PageRank スコア |
| `createdAt` | `string` | 作成日時（ISO 8601） |
| `updatedAt` | `string` | 更新日時（ISO 8601） |
| `linkedEntities` | `object[]` | グラフエッジで直接接続されているエンティティの配列 |
| `linkedEntities[].id` | `string` | リンク先エンティティ ID |
| `linkedEntities[].label` | `string` | リンク先エンティティ名 |
| `linkedEntities[].category` | `string` | リンク先エンティティのカテゴリ |
| `linkedEntities[].kind` | `string` | リンク先エンティティの種別 |
| `linkedEntities[].relationships` | `object[]` | 2つのエンティティ間のリレーションシップ記述子 |
| `linkedEntities[].relationships[].direction` | `string` | エッジの方向（`outgoing` または `incoming`） |
| `linkedEntities[].relationships[].type` | `string` | リレーションシップタイプ（例: `related_to`） |
| `linkedEntities[].relationships[].weight` | `number` | エッジの重み（0〜1） |
| `agentRuns` | `object[]` | このエンティティにリンクされたエージェント実行 |
| `agentRuns[].id` | `string` | エージェント実行 ID |
| `agentRuns[].status` | `string` | 実行ステータス（`completed`, `running`, `error` 等） |
| `agentRuns[].process` | `object[]` | エージェント実行のプロセスイベント配列 |
| `agentRuns[].createdAt` | `string` | 実行の作成日時（ISO 8601） |
| `agentRuns[].updatedAt` | `string` | 実行の更新日時（ISO 8601） |
| `agentRuns[].agentId` | `string` | この実行を行ったエージェント ID |
| `agentRuns[].agentName` | `string` | エージェント名 |
| `agentRuns[].linkedSources` | `object[]` | このエージェント実行で使用されたソース |
| `agentRuns[].linkedSources[].id` | `string` | ソース ID |
| `agentRuns[].linkedSources[].url` | `string` | ソース URL |
| `agentRuns[].linkedSources[].title` | `string` | ソースタイトル |
| `agentRuns[].linkedSources[].sourceType` | `string` | ソース種別（`public` または `private`） |
| `agentRuns[].linkedEntityIds` | `string[]` | このエージェント実行にリンクされたエンティティ ID |
| `agentRuns[].linkedEntities` | `object[]` | このエージェント実行にリンクされたエンティティのサマリー |
| `agentRuns[].linkedEntities[].id` | `string` | エンティティ ID |
| `agentRuns[].linkedEntities[].label` | `string` | エンティティ名 |
| `agentRuns[].linkedEntities[].category` | `string` | エンティティカテゴリ |
| `agentRuns[].linkedEntities[].kind` | `string` | エンティティ種別 |
各エージェント実行の `process` フィールドは、プロセスイベントの配列です。イベントタイプとペイロードの完全な一覧は、[SSE ストリーミングのドキュメント](/ja/api-reference/stream-agent-run)を参照してください。
## 使用例
```bash cURL theme={null}
curl "https://app.snorbe.deskrex.ai/api/v1/graph/entity/clxxx001" \
-H "Authorization: Bearer snorbe_your_api_key_here"
```
```python Python theme={null}
import requests
resp = requests.get(
"https://app.snorbe.deskrex.ai/api/v1/graph/entity/clxxx001",
headers={"Authorization": "Bearer snorbe_your_api_key_here"},
)
data = resp.json()
if data:
print(f"Entity: {data['label']} ({data['category']})")
print(f"Agent Runs: {len(data['agentRuns'])}")
print(f"Linked Entities: {len(data['linkedEntities'])}")
else:
print("Entity not found")
```
```typescript TypeScript theme={null}
const resp = await fetch(
"https://app.snorbe.deskrex.ai/api/v1/graph/entity/clxxx001",
{ headers: { Authorization: "Bearer snorbe_your_api_key_here" } },
);
const data = await resp.json();
if (data) {
console.log(`Entity: ${data.label} (${data.category})`);
console.log(`Agent Runs: ${data.agentRuns.length}`);
console.log(`Linked Entities: ${data.linkedEntities.length}`);
}
```
## エラーレスポンス
| HTTP ステータス | 説明 |
| ---------- | ------------------------------- |
| 401 | API キーが無効、期限切れ、または未指定 |
| 404 | エンティティが見つかりません（`null` ボディを返します） |