REST API リファレンス

この workspace で使えるローカル / リモート dispatch targets を一覧表示します。可否、runtime policy、control 状態、互換性要約を含みます。

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

1 つの dispatch target を取得し、remote control capability か local runtime summary を確認します。

runtime policy、review 状態、incident handoff、recent runs、recent audit、影響中の仕事などを確認します。

dispatch target に手動 hold をかけます。最新の runtime CAS token が必要です。

Body: { reason, releaseAfter?, expectedRuntimeUpdatedAt }

手動 hold を解除し、同じ CAS 保護 mutation で有効 policy を再計算します。

Body: { note?, expectedRuntimeUpdatedAt }

現在の policy epoch に対する governance review を処理済みとして記録します。

Body: { note?, expectedRuntimeUpdatedAt }

現在の incident epoch に対する provider incident handoff を記録します。

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

任意の metadata 付きで 1 件の memory を保存します。

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

自然言語クエリで memory を検索する GET 版です。

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

構造化 POST body で memory を検索します。複雑な条件のときに向いています。

Body: { query, spaces?, limit? }

現在のユーザーが持つ memory の総数を返します。

最大 100 件の memory を 1 回で保存します。transactional と partial success を選べます。

Body: { memories[], transactional? }

最大 50 件の検索を並列実行し、必要なら重複除去も行えます。

Body: { queries[], deduplicate? }

現在のユーザーが使っている memory spaces を一覧表示します。

意味検索、タグ、時間条件を組み合わせた memory query を実行します。

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

token 予算内で LLM の context window に入れる memory を選びます。

Body: { query, tokenBudget }

大きな memory export を Server-Sent Events で順次出力します。

Query: spaces?

recent runs を target kind、control truth、approval links、operator guidance 付きで返します。

1 つの run について、events、approvals、remote control state、推奨アクションを返します。

1 つの run に対する control capability truth、block reasons、operator guidance を返します。

remote state を強制再取得し、遅れて届いた terminal truth と整合させます。

timeout や一時的失敗のあとで remote cancel を再試行します。

remote recovery が尽きた後に、ガード付きの operator resolution を実行します。

local compatibility、remote escalation、target governance、attention backlog の health summary を返します。

現在の agent が処理できる pending local executions を一覧表示します。

呼び出し元が用意した claim token で local execution を claim します。

Body: { claimToken, workerId? }

現在の lease を延長し、必要なら進捗も報告します。

Body: { claimToken, progressMessage? }

claim 済み execution を完了します。

Body: { claimToken, result?, idempotencyKey? }

runtime がローカル中断を求めたあと、cancel を受け取ったことを返します。

Body: { claimToken, note? }

現在の tenant に属する team members を一覧表示します。

email で新しい member を招待します。OWNER または ADMIN が必要です。

Body: { email, role? }

team member の role を変更します。

Body: { role }

member を team から外します。

action、resource、期間、limit で audit logs を検索します。

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

現在のユーザーの subscription plan を取得します。

memory、API keys、agents、seats、rate limits を含む usage summary を返します。

新しい API key を作成します。生の key 値はレスポンスで 1 度だけ表示されます。

Body: { name }

現在のユーザーの API keys を一覧表示します。値はマスクされています。

API key を完全に無効化します。

device authorization flow を開始し、device_code、user_code、verification_uri を返します。

Body: { client_id, scope? }

ユーザーが承認したあとで token を polling します。

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