Sample code for 30+ languages & platforms
Unicode C++ Requires Chilkat v11.0.0+

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 Unicode C++ Downloads

Unicode C++
#include <CkHttpW.h>
#include <CkStringBuilderW.h>
#include <CkHttpResponseW.h>
#include <CkJsonObjectW.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.

    CkHttpW http;
    http.put_RequireSslCertVerify(true);
    http.put_BasicAuth(true);
    //  Read these credentials from private application configuration.
    http.put_Login(L"YOUR_ATLASSIAN_EMAIL");
    http.put_Password(L"YOUR_API_TOKEN");
    const wchar_t *baseUrl = L"https://your-domain.atlassian.net";
    http.put_Accept(L"application/json");
    CkStringBuilderW url;
    CkHttpResponseW resp;
    CkJsonObjectW reply;
    http.SetUrlVar(L"projectKey",L"PROJECT");
    const wchar_t *issueTypeName = L"Task";
    const wchar_t *issueTypeId = L"";
    int matches = 0;
    int typesStart = 0;
    bool typesMore = true;
    CkStringBuilderW typesOffset;
    while ((typesMore == true)) {
        typesOffset.Clear();
        typesOffset.AppendInt(typesStart);
        http.SetUrlVar(L"offset",typesOffset.getAsString());
        url.SetString(baseUrl);
        url.Append(L"/rest/api/3/issue/createmeta/{$projectKey}/issuetypes?startAt={$offset}&maxResults=50");
        success = http.HttpNoBody(L"GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            wprintf(L"No HTTP response was received. Check connectivity and TLS settings.\n");
            return;
        }

        if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
            wprintf(L"Request failed. HTTP %d\n",resp.get_StatusCode());
            if (resp.get_StatusCode() == 429) {
                wprintf(L"Rate limited. Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
            }

            //  Inspect this response locally; it can contain private Jira data.
            wprintf(L"%s\n",resp.bodyStr());
            return;
        }

        success = reply.Load(resp.bodyStr());
        if (success != true) {
            wprintf(L"Expected a JSON object in the response.\n");
            return;
        }

        if (reply.JsonTypeOf(L"issueTypes") != 4) {
            wprintf(L"Expected an array: issueTypes\n");
            return;
        }

        int typesCount = reply.SizeOfArray(L"issueTypes");
        int typesIndex = 0;
        while ((typesIndex < typesCount)) {
            reply.put_I(typesIndex);
            wprintf(L"%s  ID: %s\n",reply.stringOf(L"issueTypes[i].name"),reply.stringOf(L"issueTypes[i].id"));
            if (reply.StringOfEquals(L"issueTypes[i].name",issueTypeName,true) == true) {
                issueTypeId = reply.stringOf(L"issueTypes[i].id");
                matches = matches + 1;
            }

            typesIndex = typesIndex + 1;
        }

        typesStart = typesStart + typesCount;
        typesMore = (typesStart < reply.IntOf(L"total"));
        if ((typesMore == true) && (typesCount == 0)) {
            wprintf(L"Pagination made no progress; stopping.\n");
            return;
        }

    }

    if (matches != 1) {
        wprintf(L"Select one unambiguous issue type from the returned list.\n");
        return;
    }

    http.SetUrlVar(L"issueTypeId",issueTypeId);
    int fieldsStart = 0;
    bool fieldsMore = true;
    CkStringBuilderW fieldsOffset;
    while ((fieldsMore == true)) {
        fieldsOffset.Clear();
        fieldsOffset.AppendInt(fieldsStart);
        http.SetUrlVar(L"offset",fieldsOffset.getAsString());
        url.SetString(baseUrl);
        url.Append(L"/rest/api/3/issue/createmeta/{$projectKey}/issuetypes/{$issueTypeId}?startAt={$offset}&maxResults=50");
        success = http.HttpNoBody(L"GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            wprintf(L"No HTTP response was received. Check connectivity and TLS settings.\n");
            return;
        }

        if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
            wprintf(L"Request failed. HTTP %d\n",resp.get_StatusCode());
            if (resp.get_StatusCode() == 429) {
                wprintf(L"Rate limited. Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
            }

            //  Inspect this response locally; it can contain private Jira data.
            wprintf(L"%s\n",resp.bodyStr());
            return;
        }

        success = reply.Load(resp.bodyStr());
        if (success != true) {
            wprintf(L"Expected a JSON object in the response.\n");
            return;
        }

        if (reply.JsonTypeOf(L"fields") != 4) {
            wprintf(L"Expected an array: fields\n");
            return;
        }

        //  Full metadata includes field schemas and allowed values.
        wprintf(L"%s\n",reply.emit());
        int fieldsCount = reply.SizeOfArray(L"fields");
        int fieldsIndex = 0;
        while ((fieldsIndex < fieldsCount)) {
            reply.put_I(fieldsIndex);
            wprintf(L"%s  %s  Required: %d\n",reply.stringOf(L"fields[i].fieldId"),reply.stringOf(L"fields[i].name"),reply.BoolOf(L"fields[i].required"));
            fieldsIndex = fieldsIndex + 1;
        }

        fieldsStart = fieldsStart + fieldsCount;
        fieldsMore = (fieldsStart < reply.IntOf(L"total"));
        if ((fieldsMore == true) && (fieldsCount == 0)) {
            wprintf(L"Pagination made no progress; stopping.\n");
            return;
        }

    }
    }