missions

Open (create or attach) a mission

Open (create or attach) a mission: the investigation-level grouping over nodes, jobs, commands, and artifacts, with an org-unique human-readable name. Use one per question you are answering ("serve llama-70b under $X"), and open it FIRST - before the first create_node or submit_job - then pass mission: "<name>" on create_node / run_command / submit_job / submit_jobs / export_file: their work and cost roll up on the mission's page and get_mission, telemetry arrives labeled by mission (query_metrics / query_logs / search_traces), starter charts draw automatically, and save_chart adds the views worth keeping. The response's url is the human's window on the work - hand it over early, not with the final report. The page is org-private (sign-in, workspace visibility): the url discloses nothing outside the org. Create-or-attach by name: reconnecting (or a fleet of parallel agents) reuses the same name and lands in the same mission. Names are permanent org-wide handles - pick a meaningful one. Missions are optional and never required; they never cap or gate anything (workspaces are policy; missions are reporting). Declare the verdict with finish_mission when the question is answered. If the org cannot start paid work right now (no credit, an unpaid invoice, a suspended org), the response carries a warning naming the blocker and its cure - surface it to the human WITH the url, so they fix billing before watching an empty page.

post/preview/missions

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/missions
  • Auth: HTTP bearer

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

namestring nullable

Mission name: lowercase letters, digits, '-' (1-63 chars), unique in your organization and PERMANENT (missions are never deleted or renamed). Pick a meaningful one - it is the receipt's handle, the URL, and the invoice line. An existing name attaches instead of creating (create-or-attach): reconnecting agents and parallel sessions share one mission by using one name. Omitted = auto-generated.

titlestring nullable

One-line human description, shown beside the name on the mission page. Ignored when attaching to an existing mission.

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.