Jira Cloud: Discover Issue Types and Required Fields
See more Jira Examples
List a project's available issue types, then retrieve the creation fields for the type selected by name. Required fields and allowed values depend on project configuration. Inspect the returned field metadata before adapting the create-issue example. The current project-scoped metadata endpoints replace the deprecated general create-metadata endpoint.
The code lists field IDs and required flags, plus the full field metadata for each page (including schemas and allowed values). Field names are display labels; submit the returned field ID, such as customfield_10042. A field can be absent from the create screen or require a project-specific value.
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();
http.SetUrlVar("projectKey","PROJECT");
String issueTypeName = "Task";
String issueTypeId = "";
int matches = 0;
int typesStart = 0;
boolean typesMore = true;
CkStringBuilder typesOffset = new CkStringBuilder();
while ((typesMore == true)) {
typesOffset.Clear();
typesOffset.AppendInt(typesStart);
http.SetUrlVar("offset",typesOffset.getAsString());
url.SetString(baseUrl);
url.Append("/rest/api/3/issue/createmeta/{$projectKey}/issuetypes?startAt={$offset}&maxResults=50");
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("issueTypes") != 4) {
System.out.println("Expected an array: issueTypes");
return;
}
int typesCount = reply.SizeOfArray("issueTypes");
int typesIndex = 0;
while ((typesIndex < typesCount)) {
reply.put_I(typesIndex);
System.out.println(reply.stringOf("issueTypes[i].name") + " ID: " + reply.stringOf("issueTypes[i].id"));
if (reply.StringOfEquals("issueTypes[i].name",issueTypeName,true) == true) {
issueTypeId = reply.stringOf("issueTypes[i].id");
matches = matches+1;
}
typesIndex = typesIndex+1;
}
typesStart = typesStart+typesCount;
typesMore = (typesStart < reply.IntOf("total"));
if ((typesMore == true) && (typesCount == 0)) {
System.out.println("Pagination made no progress; stopping.");
return;
}
}
if (matches != 1) {
System.out.println("Select one unambiguous issue type from the returned list.");
return;
}
http.SetUrlVar("issueTypeId",issueTypeId);
int fieldsStart = 0;
boolean fieldsMore = true;
CkStringBuilder fieldsOffset = new CkStringBuilder();
while ((fieldsMore == true)) {
fieldsOffset.Clear();
fieldsOffset.AppendInt(fieldsStart);
http.SetUrlVar("offset",fieldsOffset.getAsString());
url.SetString(baseUrl);
url.Append("/rest/api/3/issue/createmeta/{$projectKey}/issuetypes/{$issueTypeId}?startAt={$offset}&maxResults=50");
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("fields") != 4) {
System.out.println("Expected an array: fields");
return;
}
// Full metadata includes field schemas and allowed values.
System.out.println(reply.emit());
int fieldsCount = reply.SizeOfArray("fields");
int fieldsIndex = 0;
while ((fieldsIndex < fieldsCount)) {
reply.put_I(fieldsIndex);
System.out.println(reply.stringOf("fields[i].fieldId") + " " + reply.stringOf("fields[i].name") + " Required: " + reply.BoolOf("fields[i].required"));
fieldsIndex = fieldsIndex+1;
}
fieldsStart = fieldsStart+fieldsCount;
fieldsMore = (fieldsStart < reply.IntOf("total"));
if ((fieldsMore == true) && (fieldsCount == 0)) {
System.out.println("Pagination made no progress; stopping.");
return;
}
}
}
}