missions

Start a mission: the entry point for handing an existing plan or build off to the AI agent team

Hand 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. Starts the mission by exactly the same route every other trigger uses, so the entry record you pass here is what decides where the run begins.

post/missions/{issueId}/start

Request

Base URL: https://api.letsship.ai/v1
URL: https://api.letsship.ai/v1/missions/{issueId}/start
Auth: none declared

Path parameters

issueIdstring required

Headers

idempotency-keystring

Retrying a request with the same key charges it once and starts (or delivers) it once. Use a new key for new work.

Example:7f9c2ba4-e88f-11ee-9a1a-0242ac120002

Request body

projectIdstring required

startAt'builder' | 'reviewer' | 'qa' nullable

planstring

prNumberinteger

acceptanceCriteriastring[]

Builder entry only. Criteria supplied with the plan; they win over the ones scraped from the issue body.

Example request

{
  "filePlan": [
    {
      "path": "src/search/rate-limit.ts",
      "action": "create",
      "description": "Token-bucket limiter for the search route"
    }
  ],
  "agents": {
    "planner": {
      "prompt": {
        "mode": "extend"
      },
      "size": {
        "vcpu": 2,
        "memoryMib": 8192,
        "diskMb": 16000
      }
    },
    "builder": {
      "prompt": {
        "mode": "extend"
      },
      "size": {
        "vcpu": 2,
        "memoryMib": 8192,
        "diskMb": 16000
      }
    },
    "reviewer": {
      "prompt": {
        "mode": "extend"
      },
      "size": {
        "vcpu": 2,
        "memoryMib": 8192,
        "diskMb": 16000
      }
    },
    "qa": {
      "prompt": {
        "mode": "extend"
      },
      "size": {
        "vcpu": 2,
        "memoryMib": 8192,
        "diskMb": 16000
      }
    }
  }
}

Response

Started

okboolean required

issueIdstring required

Changes

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