# TransitionIssueRequest

Moves an issue to another state, checked against the state machine.

**Type**: `object`

## Properties

- name: comment (optional)
  type: string
  description: A comment posted with the transition, in the same transaction; required, with new evidence, when an agent reopens a `NOT_A_PROBLEM` issue.

- name: duplicateOf (optional)
  type: string
  description: The surviving issue's id or number; required exactly when `resolution` is `DUPLICATE`.

- name: evidence (optional)
  type: array of `IssueEvidence`
  description: Evidence added to the issue with the transition.

- name: force (optional)
  type: boolean
  description: Lets a person move to Monitoring or Closed while assignees are still active; people only.

- name: guidance (optional)
  type: boolean
  description: Makes `comment` a guidance comment, which agents weigh; people only, so closing as `IGNORED` with guidance is one call.

- name: resolution (optional)
  type: enum: `FIXED`, `DUPLICATE`, `NOT_A_PROBLEM`, `IGNORED`, `OBSOLETE`, `EXPIRED`
  description: Why it closes; required when `to` is `CLOSED`, absent otherwise.

- name: to (required)
  type: enum: `TRIAGE`, `READY`, `IN_PROGRESS`, `WAITING`, `MONITORING`, `CLOSED`
  description: The target state. Moving an open issue to the state it is already in changes no state but still applies `comment` and `evidence`; it rejects `resolution`, `duplicateOf` and `force`, which need a state change.

- name: version (optional)
  type: integer
  description: The version the transition was decided against, or null to apply it to whatever is current.