REST API 參考

列出這個工作區可用的本地與遠端 dispatch targets，包含可否分派、runtime policy、控制狀態與相容性摘要。

Query: search?, targetKind? (LOCAL_AGENT|REMOTE_A2A), state?, limit?, offset?

查看單一 dispatch target，包含遠端控制能力或本地 runtime 摘要。

查看治理細節，例如 runtime policy、review 狀態、incident handoff、近期 runs、稽核與受影響工作。

對 dispatch target 施加人工 hold。需要最新的 runtime CAS token。

Body: { reason, releaseAfter?, expectedRuntimeUpdatedAt }

解除人工 hold，並在同一次 CAS 保護的 mutation 裡重新計算有效 policy。

Body: { note?, expectedRuntimeUpdatedAt }

確認目前 policy epoch 上的治理 review 已被處理。

Body: { note?, expectedRuntimeUpdatedAt }

記錄目前 incident epoch 的 provider incident handoff。

Body: { externalIncidentId, owner, note?, expectedRuntimeUpdatedAt }

寫入單筆記憶內容，可附帶 metadata。

Body: { content, space?, summary?, tags?, sensitivity?, source? }

用自然語言查詢記憶內容的 GET 版本。

Query: query (required), spaces?, limit?

用結構化 POST body 搜尋記憶，適合比較複雜的查詢。

Body: { query, spaces?, limit? }

取得目前登入使用者的記憶總數。

一次寫入最多 100 筆記憶，可選擇交易式或部分成功模式。

Body: { memories[], transactional? }

平行執行最多 50 組記憶搜尋，並可選擇去重。

Body: { queries[], deduplicate? }

列出目前使用者所有記憶 spaces。

以語意、標籤與時間條件做混合記憶查詢。

Body: { query, limit?, offset?, similarityThreshold? }

在 token 預算內，挑選適合放進 LLM context window 的記憶。

Body: { query, tokenBudget }

透過 Server-Sent Events 串流匯出記憶資料，適合大型匯出。

Query: spaces?

列出近期 runs，包含 target 類型、控制真相、approval 連結與 operator guidance。

查看 run 詳情，包含 events、approvals、遠端控制狀態與建議操作。

回傳單一 run 的控制能力真相、阻擋原因與 operator guidance。

強制重新抓取遠端狀態，對齊延後到達的 terminal truth。

在遠端 cancel 因逾時或暫時性失敗時重新嘗試。

當遠端 recovery 已耗盡後，執行受保護的 operator resolution。

查看 local compatibility、remote escalation、target governance 與 attention backlog 的健康摘要。

列出目前 agent 可領取的待處理本地 executions。

用呼叫方提供的 claim token 領取一筆本地 execution。

Body: { claimToken, workerId? }

延長目前 lease，並可選擇回報進度。

Body: { claimToken, progressMessage? }

完成已領取的 execution。

Body: { claimToken, result?, idempotencyKey? }

在 runtime 要求本地中斷後，回報 cancel 已被接收。

Body: { claimToken, note? }

列出目前 tenant 的所有團隊成員。

用 email 邀請新成員。需要 OWNER 或 ADMIN 權限。

Body: { email, role? }

修改團隊成員角色。

Body: { role }

將成員移出團隊。

依 action、resource、日期區間與 limit 條件查詢 audit logs。

Query: action?, resource?, startDate?, endDate?, limit? (default: 100)

取得目前使用者的訂閱方案。

查看記憶體、API keys、agents、席次與 rate limits 的使用量統計。

建立新的 API key。原始 key 值只會在回應中顯示一次。

Body: { name }

列出目前使用者所有 API keys。值會被遮罩。

永久撤銷一組 API key。

啟動 device authorization flow，回傳 device_code、user_code 與 verification_uri。

Body: { client_id, scope? }

在使用者完成授權後輪詢 token。

Body: { grant_type: "urn:ietf:params:oauth:grant-type:device_code", device_code }