Start a mission
start_missionHand a mission off to the AI agent team. Omit startAt for the default full run (planner first); pass startAt='builder' with a plan to skip straight to coding; pass startAt='reviewer' or startAt='qa' with an existing prNumber to hand off an existing build. Requires the missions:run token scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | No | Hand-off plan markdown, for startAt='builder' | |
| agents | No | Per-role harness/model override for THIS mission only; overrides ship.yml without changing it | |
| issueId | Yes | The mission's issue id: a Linear key or a GitHub Issues id, e.g. SHIP-244 or WEB-42 | |
| startAt | No | Pipeline stage to enter at; omit for the default full run starting at the planner | |
| prNumber | No | Existing open PR number, required for startAt='reviewer' or startAt='qa' | |
| projectId | Yes | Project id the mission belongs to |