Space/sheets

​
保存されたシートのスナップショットを非同期でエクスポート

POST
/v1/space/sheets/{sheet_id}/tabs/{tab_id}/exports
curl -X POST "https://api.orchestor.io/v1/space/sheets/%3Csheet_id%3E/tabs/%3Ctab_id%3E/exports" \  -H "Authorization: Bearer $API_KEY" \  -H "X-Workspace-ID: wks_abc123" \  -H "Content-Type: application/json" \  -d '{  "format": "csv",  "request_id": "string",  "row_ids": [    "string"  ],  "updated_at": "string"}'
{  "data": {    "completed_rows": 0,    "created_at": "2026-01-01T00:00:00Z",    "expires_at": "2026-01-01T00:00:00Z",    "filename": "<string>",    "format": "csv",    "id": "550e8400-e29b-41d4-a716-446655440000",    "sheet_id": "<string>",    "status": "queued",    "tab_id": "<string>",    "total_rows": 0  }}

Orchestor API キーを取得

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

認証

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

  • Session cookie
  • API key

認証の詳細

cookie
wos-session

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

パスパラメータ

sheet_idstringpath必須
tab_idstringpath必須

ヘッダー

X-Workspace-IDstringheader

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

例"wks_abc123"

ボディapplication/json必須

追加プロパティ
許可しない
formatstringenum<string>body必須
許可される値
csvxlsxjson
request_idstringbody必須形式:uuid
row_idsstring[]body
要素数
≥ 1, ≤ 100000
row_ids[]stringbody
文字数
≥ 1, ≤ 256
updated_atstringbody必須形式:date-time

レスポンス

application/json

プライベートエクスポートジョブ。ダウンロードは24時間利用可能です

dataobject必須
data.completed_rowsinteger必須
値の範囲
≥ 0
data.created_atstring必須形式:date-time
data.expires_atstring必須形式:date-time
data.filenamestring必須
data.formatstringenum<string>必須
許可される値
csvxlsxjson
data.idstring必須形式:uuid
data.sheet_idstring必須
data.statusstringenum<string>必須
許可される値
queuedprocessingcompletedfailed
data.tab_idstring必須
data.total_rowsinteger必須
値の範囲
≥ 0