Jira Cloud: Log Work on an Issue
See more Jira Examples
Record time worked on an issue, including an explicit start timestamp with timezone, a duration in seconds, and an ADF comment. Time tracking must be enabled and the account must have permission to log work.
The example uses adjustEstimate=leave to leave the remaining estimate unchanged. Other supported options include automatically reducing it or supplying a new estimate; choose deliberately for your workflow. Replace the example timestamp with the actual start time. Re-running the request creates a second worklog.
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
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)
request = chilkat.CkJsonObject()
request.UpdateString("started","2026-11-20T09:00:00.000+0000")
request.UpdateInt("timeSpentSeconds",1800)
# Jira v3 rich text is an Atlassian Document Format (ADF) document.
request.UpdateString("comment.type","doc")
request.UpdateInt("comment.version",1)
request.UpdateString("comment.content[0].type","paragraph")
request.UpdateString("comment.content[0].content[0].type","text")
request.UpdateString("comment.content[0].content[0].text","Work completed on this issue.")
url.SetString(baseUrl)
url.Append("/rest/api/3/issue/{$issueKey}/worklog?adjustEstimate=leave")
success = http.HttpJson("POST",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()
success = reply.Load(resp.bodyStr())
if (success != True):
print("Expected a JSON object in the response.")
sys.exit()
print("Worklog ID: " + reply.stringOf("id"))
print("Seconds recorded: " + str(reply.IntOf("timeSpentSeconds")))