Table of Contents

Class SetIssueStateRequest

Namespace
Quilt4Net.Toolkit.Features.Issue
Assembly
Quilt4Net.Toolkit.dll

Moves an issue to another state. Requires an API key carrying the issue:write scope.

public record SetIssueStateRequest : IEquatable<SetIssueStateRequest>
Inheritance
SetIssueStateRequest
Implements
Inherited Members

Remarks

The move is checked against the team's workflow. A transition the workflow does not permit is rejected, and the rejection names the states the issue can reach from where it is.

Properties

Resolution

Why the issue is ending, naming one of the workflow's resolutions. Required when State is terminal; rejected when it is not.

public string Resolution { get; init; }

Property Value

string

Remarks

Required on the way in and cleared on the way out, deliberately. A closed issue with no reason is the ambiguity resolutions exist to remove, so the move is refused rather than defaulted — guessing Done would quietly record a delivery that may not have happened. Reopening clears it, so an issue that is closed, reopened and closed again cannot carry the first decision's reason.

State

The state to move to. Must name a state defined by the team's workflow.

public required string State { get; init; }

Property Value

string

SubState

Which phase the issue is in within State, naming one of that state's sub-states. Rejected on a terminal state, whose outcome is Resolution.

public string SubState { get; init; }

Property Value

string

Remarks

Moving to another state clears the sub-state unless this names one of the target's. Naming the state the issue is already in changes only the sub-state, and needs no transition: null leaves it as it is, an empty string clears it.

null by default so a client built before sub-states existed — which re-sends the current state to take over a claim — cannot wipe a sub-state it never knew about.