---
title: "Set a per-issue agents/baseBranch override — merged per-role, per-field onto the repo's ship.yml at resolution time (override field, then ship.yml field, then platform defaults); a role or field the override omits resolves from ship.yml"
method: PUT
path: "/missions/{issueId}/agents-override"
tags: ["missions"]
---

# Set a per-issue agents/baseBranch override — merged per-role, per-field onto the repo's ship.yml at resolution time (override field, then ship.yml field, then platform defaults); a role or field the override omits resolves from ship.yml

`PUT /missions/{issueId}/agents-override`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/missions/{issueId}/agents-override`
- Auth: none declared

## Path parameters

- `issueId` string, required

## Request body

- AgentsOverrideRequest
  - `projectId` string, required
  - `agents` object
    - `planner` AgentsOverrideRoleEntry
      - `harness` 'claude-code' | 'codex' | 'pi' | 'kilo-code' | 'open-code'
      - `model` string
      - `provider` string
      - `effort` string
      - `providerRouting` object
        - `order` string[]
        - `only` string[]
        - `ignore` string[]
        - `allowFallbacks` boolean
        - `requireParameters` boolean
        - `quantizations` string[]
        - `sort` string
        - `dataCollection` 'allow' | 'deny'
      - `checkpoint` boolean
      - `rejectOn` 'critical' | 'suggestion' | 'trivial'
      - `prompt` union
        - string
        - AgentsOverrideInlinePrompt
          - `content` string, required
          - `mode` 'replace' | 'extend'
        - AgentsOverridePathPrompt
          - `path` string, required
          - `ref` string
          - `mode` 'replace' | 'extend'
      - `sandbox` string
      - `size` union
        - 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4'
        - object
          - `vcpu` integer, required
          - `memoryMib` integer, required
          - `diskMb` integer, required
      - `mcp` union[]: Optional narrowing of the role's MCP servers/tools for this mission; can only remove access.
        - union
          - string
          - object
            - `server` string, required
            - `tools` string[]
    - `builder` AgentsOverrideRoleEntry
      - `harness` 'claude-code' | 'codex' | 'pi' | 'kilo-code' | 'open-code'
      - `model` string
      - `provider` string
      - `effort` string
      - `providerRouting` object
        - `order` string[]
        - `only` string[]
        - `ignore` string[]
        - `allowFallbacks` boolean
        - `requireParameters` boolean
        - `quantizations` string[]
        - `sort` string
        - `dataCollection` 'allow' | 'deny'
      - `checkpoint` boolean
      - `rejectOn` 'critical' | 'suggestion' | 'trivial'
      - `prompt` union
        - string
        - AgentsOverrideInlinePrompt
          - `content` string, required
          - `mode` 'replace' | 'extend'
        - AgentsOverridePathPrompt
          - `path` string, required
          - `ref` string
          - `mode` 'replace' | 'extend'
      - `sandbox` string
      - `size` union
        - 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4'
        - object
          - `vcpu` integer, required
          - `memoryMib` integer, required
          - `diskMb` integer, required
      - `mcp` union[]: Optional narrowing of the role's MCP servers/tools for this mission; can only remove access.
        - union
          - string
          - object
            - `server` string, required
            - `tools` string[]
    - `reviewer` AgentsOverrideRoleEntry
      - `harness` 'claude-code' | 'codex' | 'pi' | 'kilo-code' | 'open-code'
      - `model` string
      - `provider` string
      - `effort` string
      - `providerRouting` object
        - `order` string[]
        - `only` string[]
        - `ignore` string[]
        - `allowFallbacks` boolean
        - `requireParameters` boolean
        - `quantizations` string[]
        - `sort` string
        - `dataCollection` 'allow' | 'deny'
      - `checkpoint` boolean
      - `rejectOn` 'critical' | 'suggestion' | 'trivial'
      - `prompt` union
        - string
        - AgentsOverrideInlinePrompt
          - `content` string, required
          - `mode` 'replace' | 'extend'
        - AgentsOverridePathPrompt
          - `path` string, required
          - `ref` string
          - `mode` 'replace' | 'extend'
      - `sandbox` string
      - `size` union
        - 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4'
        - object
          - `vcpu` integer, required
          - `memoryMib` integer, required
          - `diskMb` integer, required
      - `mcp` union[]: Optional narrowing of the role's MCP servers/tools for this mission; can only remove access.
        - union
          - string
          - object
            - `server` string, required
            - `tools` string[]
    - `qa` AgentsOverrideRoleEntry
      - `harness` 'claude-code' | 'codex' | 'pi' | 'kilo-code' | 'open-code'
      - `model` string
      - `provider` string
      - `effort` string
      - `providerRouting` object
        - `order` string[]
        - `only` string[]
        - `ignore` string[]
        - `allowFallbacks` boolean
        - `requireParameters` boolean
        - `quantizations` string[]
        - `sort` string
        - `dataCollection` 'allow' | 'deny'
      - `checkpoint` boolean
      - `rejectOn` 'critical' | 'suggestion' | 'trivial'
      - `prompt` union
        - string
        - AgentsOverrideInlinePrompt
          - `content` string, required
          - `mode` 'replace' | 'extend'
        - AgentsOverridePathPrompt
          - `path` string, required
          - `ref` string
          - `mode` 'replace' | 'extend'
      - `sandbox` string
      - `size` union
        - 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4'
        - object
          - `vcpu` integer, required
          - `memoryMib` integer, required
          - `diskMb` integer, required
      - `mcp` union[]: Optional narrowing of the role's MCP servers/tools for this mission; can only remove access.
        - union
          - string
          - object
            - `server` string, required
            - `tools` string[]
  - `baseBranch` string

## Response `200`

Override stored

- AgentsOverrideResponse
  - `ok` boolean, required
  - `issueId` string, required

## Other responses

- `403`: Forbidden
- `404`: Project not accessible

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)