Space/documents

​
社内 Space ドキュメントにタブを追加します。createSpaceDocument と同様に、オプションで Markdown やブロックを含めることができます

タブは最後に追加されます。name は最大255文字で、"/" は含められません。markdown および blocks は createSpaceDocument（<?claude block key?> トークン）に従います。

POST
/v1/space/documents/{document_id}/tabs
curl -X POST "https://api.orchestor.io/v1/space/documents/%3Cdocument_id%3E/tabs" \  -H "Authorization: Bearer $API_KEY" \  -H "X-Workspace-ID: wks_abc123" \  -H "Content-Type: application/json" \  -d '{  "blocks": {},  "markdown": "",  "name": "string"}'
{  "data": {    "document_id": "<string>",    "id": "<string>",    "name": "<string>",    "position": 0,    "updated_at": "2026-01-01T00:00:00Z"  }}

Orchestor API キーを取得

ワークスペースの設定から API キーを作成します。

認証

次のいずれかの条件を満たしてください。

  • Session cookie
  • API key

認証の詳細

cookie
wos-session

ウェブアプリにサインインすることで確立されるブラウザセッションです。サーバーは、ワークスペースのメンバーシップと権限を確認します。ワークスペーススコープの操作には X-Workspace-ID を指定してください。サーバー間リクエストの場合、操作がサポートしていれば API キーを使用します。

パスパラメータ

document_idstringpath必須
パターン
^doc_[a-f0-9]{24}$

ヘッダー

X-Workspace-IDstringheader

アクセスするワークスペースです。ワークスペーススコープの API キーを使用する場合、サーバーはキーからこの値を導出するため、ヘッダーは任意です。指定する場合、認証情報のワークスペースと一致する必要があり、一致しない場合リクエストは 403 workspace_mismatch を返します。インタラクティブなセッションリクエストの場合、メンバーになっているワークスペースを選択するためにこのヘッダーを指定します。プロジェクト ID をワークスペース ID として使用することはできません。

例"wks_abc123"

ボディapplication/json必須

追加プロパティ
許可しない
blocksobjectbody
blocks.*object | object | object | object | object | object | objectbody

以下のいずれかに一致

形式 1: object

blocks.*.intentstringbody必須
文字数
≤ 2000
blocks.*.typestringenum<string>body必須
許可される値
pending

形式 2: object

blocks.*.typestringenum<string>body必須
許可される値
paragraph

形式 3: object

blocks.*.captionstringbody
blocks.*.rowsobject[]body必須

チャートが描画する、計測された行です（≤ 2000 行、256 KiB）。

要素数
≤ 2000
blocks.*.rows[]objectbody
blocks.*.rows[].*string | number | boolean | nullbody

以下のいずれかに一致

形式 1: string

blocks.*.rows[].*stringbody

形式 2: number

blocks.*.rows[].*numberbody

形式 3: boolean

blocks.*.rows[].*booleanbody

形式 4: null

blocks.*.rows[].*nullbody
blocks.*.specobjectbody必須
blocks.*.spec.kindstringenum<string>body必須
許可される値
linebarpie
blocks.*.spec.seriesstringbody

VALUES が系列名を指定する列です: 系列および期間ごとに 1 行です。

blocks.*.spec.titlestringbody必須

トピックではなく、番号を含む調査結果です。

文字数
≥ 1
blocks.*.spec.unitstringbody
blocks.*.spec.xstringbody必須

軸（または円グラフのスライス）に沿った列です。

文字数
≥ 1
blocks.*.spec.ystringbody必須

計測された列（数値）です。

文字数
≥ 1
blocks.*.typestringenum<string>body必須
許可される値
chart

形式 4: object

blocks.*.captionstringbody
blocks.*.specobjectbody必須
blocks.*.spec.directionstringenum<string>body必須
許可される値
rightdown
blocks.*.spec.edgesobject[]body必須
要素数
≤ 120
blocks.*.spec.edges[]objectbody
blocks.*.spec.edges[].fromstringbody必須
blocks.*.spec.edges[].labelstringbody
blocks.*.spec.edges[].tostringbody必須
blocks.*.spec.nodesobject[]body必須
要素数
≥ 1, ≤ 60
blocks.*.spec.nodes[]objectbody
blocks.*.spec.nodes[].detailstringbody
blocks.*.spec.nodes[].idstringbody必須
パターン
^[\w-]{1,64}$
blocks.*.spec.nodes[].labelstringbody必須
文字数
≥ 1
blocks.*.spec.titlestringbody必須
文字数
≥ 1
blocks.*.typestringenum<string>body必須
許可される値
diagram

形式 5: object

blocks.*.typestringenum<string>body必須
許可される値
mention
blocks.*.userstringbody必須
文字数
≥ 1, ≤ 320

形式 6: object

blocks.*.refstringbody必須
パターン
^project\/doc_[a-f0-9]{24}$
blocks.*.typestringenum<string>body必須
許可される値
mention

形式 7: object

blocks.*.typestringenum<string>body必須
許可される値
date
blocks.*.valuestringbody必須
パターン
^\d{4}-\d{2}-\d{2}$
markdownstringbodyデフォルト:

Markdown 本文です。CLI: UTF-8 ファイルパス、または標準入力の場合は - です。

文字数
≤ 1000000
namestringbody必須
文字数
≥ 1, ≤ 255

レスポンス

application/json

作成されたタブです。

dataSpaceDocumentTab必須
data.document_idstring必須
data.idstring必須
data.namestring必須
data.positioninteger必須
data.updated_atstring必須形式:date-time