Jira Cloud: Change an Issue Status
See more Jira Examples
List the workflow transitions currently available to an issue and execute the transition selected by name. A transition is an action, not merely a destination status: use the name returned by Jira, and do not assume the ID or name is the same in every project.
The expanded transition metadata identifies fields associated with transition screens. This basic example refuses a transition with required fields so it cannot silently omit them. Adapt the POST body with the required fields before using such a transition. Workflow conditions and validators can still reject a request, and the available transitions can change between GET and POST.
The code uses an Atlassian account email and an API token without scopes with the site URL. For a scoped API token, keep Basic authentication and change baseUrl to https://api.atlassian.com/ex/jira/YOUR_CLOUD_ID. For OAuth2, use that gateway URL, omit Login/Password/BasicAuth, and set http.AuthToken to the access token. See API token authentication and OAuth2 authorization. The account must have permission for the operation; OAuth scopes do not grant additional Jira permissions.
Targets Jira Cloud. Jira Data Center has a separate REST API and may require different paths, authentication, or payloads.
Atlassian REST API documentation
Chilkat CkJava Downloads
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
http.put_BasicAuth(true);
// Read these credentials from private application configuration.
http.put_Login("YOUR_ATLASSIAN_EMAIL");
http.put_Password("YOUR_API_TOKEN");
String baseUrl = "https://your-domain.atlassian.net";
http.put_Accept("application/json");
CkStringBuilder url = new CkStringBuilder();
CkHttpResponse resp = new CkHttpResponse();
CkJsonObject reply = new CkJsonObject();
String issueKey = "PROJECT-123";
http.SetUrlVar("issueKey",issueKey);
String transitionName = "Start Progress";
String transitionId = "";
int matches = 0;
boolean needsFields = false;
url.SetString(baseUrl);
url.Append("/rest/api/3/issue/{$issueKey}/transitions?expand=transitions.fields");
success = http.HttpNoBody("GET",url.getAsString(),resp);
if (resp.get_StatusCode() == 0) {
System.out.println("No HTTP response was received. Check connectivity and TLS settings.");
return;
}
if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
System.out.println("Request failed. HTTP " + resp.get_StatusCode());
if (resp.get_StatusCode() == 429) {
System.out.println("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"));
}
// Inspect this response locally; it can contain private Jira data.
System.out.println(resp.bodyStr());
return;
}
success = reply.Load(resp.bodyStr());
if (success != true) {
System.out.println("Expected a JSON object in the response.");
return;
}
if (reply.JsonTypeOf("transitions") != 4) {
System.out.println("Expected an array: transitions");
return;
}
int i = 0;
int j = 0;
CkJsonObject fields = new CkJsonObject();
CkJsonObject field = new CkJsonObject();
while ((i < reply.SizeOfArray("transitions"))) {
reply.put_I(i);
System.out.println(reply.stringOf("transitions[i].name") + " -> " + reply.stringOf("transitions[i].to.name"));
if (reply.StringOfEquals("transitions[i].name",transitionName,true) == true) {
transitionId = reply.stringOf("transitions[i].id");
matches = matches+1;
fields = reply.ObjectOf("transitions[i].fields");
if (reply.get_LastMethodSuccess() != true) {
System.out.println("Expected expanded transition field metadata.");
return;
}
j = 0;
while ((j < fields.get_Size())) {
field = fields.ObjectAt(j);
if (field.BoolOf("required") == true) {
needsFields = true;
System.out.println("Required transition field: " + fields.nameAt(j));
}
j = j+1;
}
}
i = i+1;
}
if ((matches != 1) || (needsFields == true)) {
System.out.println("Choose one available transition and supply any required transition fields before submitting.");
return;
}
CkJsonObject request = new CkJsonObject();
request.UpdateString("transition.id",transitionId);
url.SetString(baseUrl);
url.Append("/rest/api/3/issue/{$issueKey}/transitions");
success = http.HttpJson("POST",url.getAsString(),request,"application/json",resp);
if (resp.get_StatusCode() == 0) {
System.out.println("No HTTP response was received. Check connectivity and TLS settings.");
return;
}
if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
System.out.println("Request failed. HTTP " + resp.get_StatusCode());
if (resp.get_StatusCode() == 429) {
System.out.println("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"));
}
// Inspect this response locally; it can contain private Jira data.
System.out.println(resp.bodyStr());
return;
}
System.out.println("Transition completed: " + transitionName);
}
}