ソース詳細取得

指定したソース（public または private）の詳細情報を返します。本文テキスト全体、本文から抽出されたリンク、リンクされたエージェント実行、リンクされたエンティティを含みます。

リクエスト

GET /api/v1/graph/source/{sourceId}?sourceType=public

パスパラメータ

パラメータ	型	説明
`sourceId`	`string`	ソース ID

クエリパラメータ

パラメータ	型	必須	説明
`sourceType`	`string`	はい	ソース種別: `public` または `private`

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer snorbe_...` 形式の API キー

ワークスペースは API キーに紐づくものが自動的に使用されます。workspaceId パラメータは不要です。

レスポンス

{
  "id": "clsrc001",
  "url": "https://example.com/research-paper",
  "title": "Advances in Solid-State Battery Technology",
  "description": "A comprehensive review of recent developments...",
  "body": "Solid-state batteries have emerged as a promising alternative...",
  "bodyLinks": [
    {
      "title": "Related Study",
      "url": "https://example.com/related-study",
      "type": "external"
    }
  ],
  "sourceType": "public",
  "createdAt": "2026-03-10T08:00:00.000Z",
  "agentRuns": [
    {
      "id": "clrun001",
      "status": "completed",
      "createdAt": "2026-04-01T09:00:00.000Z",
      "linkedEntityIds": ["clxxx001", "clxxx002"],
      "turnId": "clturn001"
    }
  ],
  "linkedEntities": [
    {
      "id": "clxxx001",
      "label": "Solid-State Battery",
      "category": "technology",
      "kind": "entity"
    }
  ]
}

ソースがワークスペースに存在しない場合は null を返します。

レスポンスフィールド

フィールド	型	説明
`id`	`string`	ソース ID
`url`	`string`	ソース URL
`title`	`string`	ソースタイトル
`description`	`string`	ソースの説明
`body`	`string`	ソースの本文テキスト全文
`bodyLinks`	`object[]`	本文から抽出されたリンク
`bodyLinks[].title`	`string`	リンクタイトル
`bodyLinks[].url`	`string`	リンク URL
`bodyLinks[].type`	`string`	リンクタイプ（例: `external`）
`sourceType`	`string`	ソース種別（`public` または `private`）
`createdAt`	`string`	作成日時（ISO 8601）
`agentRuns`	`object[]`	このソースを使用したエージェント実行
`agentRuns[].id`	`string`	エージェント実行 ID
`agentRuns[].status`	`string`	実行ステータス（`completed`, `running`, `error` 等）
`agentRuns[].createdAt`	`string`	実行の作成日時（ISO 8601）
`agentRuns[].linkedEntityIds`	`string[]`	このエージェント実行にリンクされたエンティティ ID
`agentRuns[].turnId`	`string \| null`	このエージェント実行に紐づくターン ID
`linkedEntities`	`object[]`	このソースから抽出またはリンクされたエンティティ
`linkedEntities[].id`	`string`	エンティティ ID
`linkedEntities[].label`	`string`	エンティティ名
`linkedEntities[].category`	`string`	エンティティカテゴリ
`linkedEntities[].kind`	`string`	エンティティ種別

使用例

curl "https://app.snorbe.deskrex.ai/api/v1/graph/source/clsrc001?sourceType=public" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

import requests

resp = requests.get(
    "https://app.snorbe.deskrex.ai/api/v1/graph/source/clsrc001",
    params={"sourceType": "public"},
    headers={"Authorization": "Bearer snorbe_your_api_key_here"},
)
data = resp.json()
if data:
    print(f"Source: {data['title']}")
    print(f"URL: {data['url']}")
    print(f"Body length: {len(data['body'])} chars")
    print(f"Links: {len(data['bodyLinks'])}")
    print(f"Agent Runs: {len(data['agentRuns'])}")
    print(f"Entities: {len(data['linkedEntities'])}")
else:
    print("Source not found")

const params = new URLSearchParams({ sourceType: "public" });
const resp = await fetch(
  `https://app.snorbe.deskrex.ai/api/v1/graph/source/clsrc001?${params}`,
  { headers: { Authorization: "Bearer snorbe_your_api_key_here" } },
);
const data = await resp.json();
if (data) {
  console.log(`Source: ${data.title}`);
  console.log(`URL: ${data.url}`);
  console.log(`Body length: ${data.body.length} chars`);
  console.log(`Links: ${data.bodyLinks.length}`);
  console.log(`Agent Runs: ${data.agentRuns.length}`);
  console.log(`Entities: ${data.linkedEntities.length}`);
}

エラーレスポンス

HTTP ステータス	説明
401	API キーが無効、期限切れ、または未指定
403	アクセス権限がありません（ソースが別のワークスペースまたはユーザーに属しています）
404	ソースが見つかりません（`null` ボディを返します）