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

Jira Cloud: Find an Assignable User and Assign an Issue

See more Jira Examples

Search for users who can be assigned an issue, display their account IDs, and validate the application's chosen account ID before assigning it. Jira Cloud uses accountId, not a username. Display names are not unique, and privacy settings may hide email addresses.

The discovery request is a short candidate search, not an export of every user. Atlassian applies a first-1000-users limitation to this resource. Narrow the query when necessary. The code intentionally does not assign the first search result: set selectedAccountId after the user or application chooses a specific account. The separate account-ID query verifies eligibility even if the candidate page was incomplete.

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 CkPython Downloads

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

http = chilkat.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")
baseUrl = "https://your-domain.atlassian.net"
http.put_Accept("application/json")
url = chilkat.CkStringBuilder()
resp = chilkat.CkHttpResponse()
reply = chilkat.CkJsonObject()
issueKey = "PROJECT-123"
http.SetUrlVar("issueKey",issueKey)
selectedAccountId = ""
http.SetUrlVar("query","Alex")
url.SetString(baseUrl)
url.Append("/rest/api/3/user/assignable/search?issueKey={$issueKey}&query={$query}&maxResults=50")
success = http.HttpNoBody("GET",url.getAsString(),resp)
if (resp.get_StatusCode() == 0):
    print("No HTTP response was received. Check connectivity and TLS settings.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() < 200) or (resp.get_StatusCode() >= 300)):
    print("Request failed. HTTP " + str(resp.get_StatusCode()))
    if (resp.get_StatusCode() == 429):
        print("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"))

    #  Inspect this response locally; it can contain private Jira data.
    print(resp.bodyStr())
    sys.exit()

users = chilkat.CkJsonArray()
success = users.Load(resp.bodyStr())
if (success != True):
    print("Expected an array of assignable users.")
    sys.exit()

i = 0
user = chilkat.CkJsonObject()
while (i < users.get_Size()) :
    # user is a CkJsonObject
    user = users.ObjectAt(i)
    print(user.stringOf("displayName") + "  Account ID: " + user.stringOf("accountId"))

    i = i + 1

if (selectedAccountId == ""):
    print("Choose an account ID, set selectedAccountId, and run again to assign the issue.")
    sys.exit()

http.SetUrlVar("accountId",selectedAccountId)
url.SetString(baseUrl)
url.Append("/rest/api/3/user/assignable/search?issueKey={$issueKey}&accountId={$accountId}")
success = http.HttpNoBody("GET",url.getAsString(),resp)
if (resp.get_StatusCode() == 0):
    print("No HTTP response was received. Check connectivity and TLS settings.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() < 200) or (resp.get_StatusCode() >= 300)):
    print("Request failed. HTTP " + str(resp.get_StatusCode()))
    if (resp.get_StatusCode() == 429):
        print("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"))

    #  Inspect this response locally; it can contain private Jira data.
    print(resp.bodyStr())
    sys.exit()

success = users.Load(resp.bodyStr())
if (success != True):
    print("Expected an array of assignable users.")
    sys.exit()

eligible = False
i = 0
while (i < users.get_Size()) :
    # user is a CkJsonObject
    user = users.ObjectAt(i)
    if ((user.StringOfEquals("accountId",selectedAccountId,True) == True) and (user.BoolOf("active") == True)):
        eligible = True

    i = i + 1

if (eligible != True):
    print("The selected account is not an active assignable user for this issue.")
    sys.exit()

request = chilkat.CkJsonObject()
request.UpdateString("accountId",selectedAccountId)
url.SetString(baseUrl)
url.Append("/rest/api/3/issue/{$issueKey}/assignee")
success = http.HttpJson("PUT",url.getAsString(),request,"application/json",resp)
if (resp.get_StatusCode() == 0):
    print("No HTTP response was received. Check connectivity and TLS settings.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() < 200) or (resp.get_StatusCode() >= 300)):
    print("Request failed. HTTP " + str(resp.get_StatusCode()))
    if (resp.get_StatusCode() == 429):
        print("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"))

    #  Inspect this response locally; it can contain private Jira data.
    print(resp.bodyStr())
    sys.exit()

print("Assigned issue: " + issueKey)