missions

Create a mission: mints the tracker issue and starts the run in one call

For a caller delegating work that has no tracker issue yet (typically a locally-authored spec handed over from a terminal). Creates a real issue in the project's tracker under your own connector (a Linear issue, or a GitHub issue on the project's repository for a GitHub-Issues project; a project with no tracker gets a platform-minted id), writes the hand-off against it, and starts the run last: by then the hand-off is already stored, so a mission never starts against a half-written entry. Use POST /missions/{issueId}/start instead when the issue already exists.

post/missions

Request

  • Base URL: https://api.letsship.ai/v1
  • URL: https://api.letsship.ai/v1/missions
  • Auth: none declared

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
titlestring

Omit only when entry.prNumber is set — the pull request's own title is then used.

descriptionstring

Issue body. Acceptance criteria written here are parsed by the planner as it would for any issue.

labelsstring[]

Example request

{
  "title": "Add a rate limit to the public search endpoint",
  "entry": {
    "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

Created

issueIdstring required
identifierstring required
urlstring required

Example response

{
  "issueId": "SHIP-412",
  "identifier": "SHIP-412",
  "url": "https://linear.app/acme/issue/SHIP-412"
}

Changes

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