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

Jira Cloud: Update Issue Fields

See more Jira Examples

Update an issue's summary and description, add a label, and remove another label. A field in fields replaces its value; operations in update can add or remove individual values. Do not put the same field in both objects.

Use GET /rest/api/3/issue/{issueIdOrKey}/editmeta to inspect editable fields and allowed operations for this issue. A commented custom-field assignment illustrates a single-line text field; replace its ID and use the value shape required by that field's schema. Updating fields does not perform a workflow transition.

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;
    const wchar_t *issueKey = L"PROJECT-123";
    http.SetUrlVar(L"issueKey",issueKey);
    CkJsonObjectW request;
    request.UpdateString(L"fields.summary",L"Updated issue summary");
    //  Jira v3 rich text is an Atlassian Document Format (ADF) document.
    request.UpdateString(L"fields.description.type",L"doc");
    request.UpdateInt(L"fields.description.version",1);
    request.UpdateString(L"fields.description.content[0].type",L"paragraph");
    request.UpdateString(L"fields.description.content[0].content[0].type",L"text");
    request.UpdateString(L"fields.description.content[0].content[0].text",L"Updated description.");
    request.UpdateString(L"update.labels[0].add",L"reviewed");
    request.UpdateString(L"update.labels[1].remove",L"needs-review");
    //  Optional: only after checking editmeta for your single-line text custom field.
    //  ignore = request.UpdateString("fields.customfield_10042","Example value");
    url.SetString(baseUrl);
    url.Append(L"/rest/api/3/issue/{$issueKey}");
    success = http.HttpJson(L"PUT",url.getAsString(),request,L"application/json",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;
    }

    //  Jira normally returns HTTP 204 with no JSON body.
    wprintf(L"Issue fields updated: %s\n",issueKey);
    }