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

Jira Cloud: Move Issues into a Sprint or Backlog

See more Jira Examples

Move selected issue keys into a chosen sprint, or remove their active/future sprint assignments to return them to the backlog. Set moveToBacklog to choose exactly one operation; the example does not move issues back immediately after adding them.

Use board and sprint discovery to obtain the sprint ID. The target must be an active or future sprint. Each request supports at most 50 issues. Moving issues does not change their workflow status; completed-sprint history is retained. The account needs the applicable project and scheduling permissions. OAuth integrations need the Jira Software scopes specified by the selected endpoint.

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;
    bool moveToBacklog = false;
    http.SetUrlVar(L"sprintId",L"YOUR_SPRINT_ID");
    CkJsonObjectW request;
    request.UpdateString(L"issues[0]",L"PROJECT-123");
    request.UpdateString(L"issues[1]",L"PROJECT-124");
    url.SetString(baseUrl);
    if (moveToBacklog == true) {
        url.Append(L"/rest/agile/1.0/backlog/issue");
    }
    else {
        url.Append(L"/rest/agile/1.0/sprint/{$sprintId}/issue");
    }

    success = http.HttpJson(L"POST",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;
    }

    wprintf(L"Issue sprint assignments updated.\n");
    }