Sample code for 30+ languages & platforms
Visual FoxPro Requires Chilkat v11.0.0+

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 Visual FoxPro Downloads

Visual FoxPro
LOCAL lnSuccess
LOCAL loHttp
LOCAL lcBaseUrl
LOCAL loUrl
LOCAL loResp
LOCAL loReply
LOCAL lcIssueKey
LOCAL lcTransitionName
LOCAL lcTransitionId
LOCAL lnMatches
LOCAL lnNeedsFields
LOCAL i
LOCAL j
LOCAL loFields
LOCAL loField
LOCAL loRequest

lnSuccess = 0

*  Assumes Chilkat is unlocked. See Global Unlock Sample.

loHttp = CreateObject('Chilkat.Http')
loHttp.RequireSslCertVerify = 1
loHttp.BasicAuth = 1
*  Read these credentials from private application configuration.
loHttp.Login = "YOUR_ATLASSIAN_EMAIL"
loHttp.Password = "YOUR_API_TOKEN"
lcBaseUrl = "https://your-domain.atlassian.net"
loHttp.Accept = "application/json"
loUrl = CreateObject('Chilkat.StringBuilder')
loResp = CreateObject('Chilkat.HttpResponse')
loReply = CreateObject('Chilkat.JsonObject')
lcIssueKey = "PROJECT-123"
loHttp.SetUrlVar("issueKey",lcIssueKey)
lcTransitionName = "Start Progress"
lcTransitionId = ""
lnMatches = 0
lnNeedsFields = 0
loUrl.SetString(lcBaseUrl)
loUrl.Append("/rest/api/3/issue/{$issueKey}/transitions?expand=transitions.fields")
lnSuccess = loHttp.HttpNoBody("GET",loUrl.GetAsString(),loResp)
IF (loResp.StatusCode = 0) THEN
    ? "No HTTP response was received. Check connectivity and TLS settings."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

IF ((lnSuccess <> 1) OR (loResp.StatusCode < 200) OR (loResp.StatusCode >= 300)) THEN
    ? "Request failed. HTTP " + STR(loResp.StatusCode)
    IF (loResp.StatusCode = 429) THEN
        ? "Rate limited. Retry-After: " + loResp.GetHeaderField("Retry-After")
    ENDIF

    *  Inspect this response locally; it can contain private Jira data.
    ? loResp.BodyStr
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

lnSuccess = loReply.Load(loResp.BodyStr)
IF (lnSuccess <> 1) THEN
    ? "Expected a JSON object in the response."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

IF (loReply.JsonTypeOf("transitions") <> 4) THEN
    ? "Expected an array: transitions"
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

i = 0
j = 0
loFields = CreateObject('Chilkat.JsonObject')
loField = CreateObject('Chilkat.JsonObject')
DO WHILE (i < loReply.SizeOfArray("transitions"))
    loReply.I = i
    ? loReply.StringOf("transitions[i].name") + " -> " + loReply.StringOf("transitions[i].to.name")
    IF (loReply.StringOfEquals("transitions[i].name",lcTransitionName,1) = 1) THEN
        lcTransitionId = loReply.StringOf("transitions[i].id")
        lnMatches = lnMatches + 1
        loFields = loReply.ObjectOf("transitions[i].fields")
        IF (loReply.LastMethodSuccess <> 1) THEN
            ? "Expected expanded transition field metadata."
            RELEASE loHttp
            RELEASE loUrl
            RELEASE loResp
            RELEASE loReply
            RELEASE loFields
            RELEASE loField
            CANCEL
        ENDIF

        j = 0
        DO WHILE (j < loFields.Size)
            loField = loFields.ObjectAt(j)
            IF (loField.BoolOf("required") = 1) THEN
                lnNeedsFields = 1
                ? "Required transition field: " + loFields.NameAt(j)
            ENDIF

            RELEASE loField
            j = j + 1
        ENDDO
        RELEASE loFields
    ENDIF

    i = i + 1
ENDDO
IF ((lnMatches <> 1) OR (lnNeedsFields = 1)) THEN
    ? "Choose one available transition and supply any required transition fields before submitting."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loFields
    RELEASE loField
    CANCEL
ENDIF

loRequest = CreateObject('Chilkat.JsonObject')
loRequest.UpdateString("transition.id",lcTransitionId)
loUrl.SetString(lcBaseUrl)
loUrl.Append("/rest/api/3/issue/{$issueKey}/transitions")
lnSuccess = loHttp.HttpJson("POST",loUrl.GetAsString(),loRequest,"application/json",loResp)
IF (loResp.StatusCode = 0) THEN
    ? "No HTTP response was received. Check connectivity and TLS settings."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loFields
    RELEASE loField
    RELEASE loRequest
    CANCEL
ENDIF

IF ((lnSuccess <> 1) OR (loResp.StatusCode < 200) OR (loResp.StatusCode >= 300)) THEN
    ? "Request failed. HTTP " + STR(loResp.StatusCode)
    IF (loResp.StatusCode = 429) THEN
        ? "Rate limited. Retry-After: " + loResp.GetHeaderField("Retry-After")
    ENDIF

    *  Inspect this response locally; it can contain private Jira data.
    ? loResp.BodyStr
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loFields
    RELEASE loField
    RELEASE loRequest
    CANCEL
ENDIF

? "Transition completed: " + lcTransitionName

RELEASE loHttp
RELEASE loUrl
RELEASE loResp
RELEASE loReply
RELEASE loFields
RELEASE loField
RELEASE loRequest