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 Unicode C++ Downloads
#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"started",L"2026-11-20T09:00:00.000+0000");
request.UpdateInt(L"timeSpentSeconds",1800);
// Jira v3 rich text is an Atlassian Document Format (ADF) document.
request.UpdateString(L"comment.type",L"doc");
request.UpdateInt(L"comment.version",1);
request.UpdateString(L"comment.content[0].type",L"paragraph");
request.UpdateString(L"comment.content[0].content[0].type",L"text");
request.UpdateString(L"comment.content[0].content[0].text",L"Work completed on this issue.");
url.SetString(baseUrl);
url.Append(L"/rest/api/3/issue/{$issueKey}/worklog?adjustEstimate=leave");
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;
}
success = reply.Load(resp.bodyStr());
if (success != true) {
wprintf(L"Expected a JSON object in the response.\n");
return;
}
wprintf(L"Worklog ID: %s\n",reply.stringOf(L"id"));
wprintf(L"Seconds recorded: %d\n",reply.IntOf(L"timeSpentSeconds"));
}