research

Submit a plan, an instruction, an answer, a handoff, or complete

Change a research mission, one action per call, against the version you read: plan submits a research.plan/v1 plan against the remaining budget (new ids; controls name earlier experiments); instruction directs the managed researcher without choosing experiments; question_id + answer answers its open question; planner ("customer" or "managed") hands control over - needs expected_control_version and accepted_work ("continue" or "cancel"); complete closes customer-directed work once nothing is running. A stale expected_version is refused: read get_research and retry. Changes are recorded and audited; none of them weakens the check set or raises the budget.

post/preview/research/{name}/steer

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/research/{name}/steer
  • Auth: HTTP bearer

Path parameters

namestring required

Mission name.

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

accepted_workstring nullable

What happens to work already admitted on a handoff: "continue" (default) or "cancel".

answerstring nullable
completeboolean nullable

Close customer-directed work; the results keep their evaluation status. Needs expected_control_version.

expected_control_versioninteger nullable

The control version you read; required for a handoff or completion.

expected_versioninteger required

The mission version you read (get_research version). A stale version is refused: read again before resubmitting.

idempotency_keystring nullable

Replay protection for this change.

instructionstring nullable

Direct the managed researcher without selecting experiments.

planunknown
plannerstring nullable

Hand control over: "customer" assigns you, "managed" the platform's researcher. Needs expected_control_version and accepted_work.

question_idstring nullable

Answer the open question (its id is on get_research).

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.