# StartInvestigationRequest

Request body for the manual-trigger endpoint. The engineer's user identity is taken from the request's auth context, not the body.

**Type**: `object`

## Properties

- name: agentId (required)
  type: string
  description: TSID of the agent to investigate.

- name: issueId (optional)
  type: string
  description: When set, hands the agent this issue (its TSID): the run's subject, which its known issues hold alone and whose history records the handoff. Only a person may hand off an issue, and a handoff can't be a continuation. `null` for a plain run.

- name: next (optional)
  type: boolean
  description: With `issueId`, true to have the agent work on the issue next: the run starts ahead of the agent's other queued runs, without stopping a running one. Allowed only with `issueId`; `null` or false for the usual place in the queue.

- name: parentInvestigationId (optional)
  type: string
  description: When set, seeds the new investigation from this parent's journalled transcript — a continuation; the parent must belong to `agentId`. `null` for a fresh investigation.

- name: userProvidedContext (optional)
  type: string
  description: Free-form context for the agent's first turn, or `null`.