Skip to content

Function: getIssueWorklog() ​

ts
function getIssueWorklog(
   client, 
   parameters, 
   options?
): Promise<{
[key: string]: unknown;
  maxResults?: number;
  startAt?: number;
  total?: number;
  worklogs?: object[];
}>;

Defined in: src/cloud/api/issueWorklogs.ts:33

Returns worklogs for an issue (ordered by created time), starting from the oldest worklog or from the worklog started on or after a date and time.

Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see Configuring time tracking.

This operation can be accessed anonymously.

Permissions required: Workloads are only returned where the user has:

  • Browse projects project permission for the project that the issue is in.
  • If issue-level security is configured, issue-level security permission to view the issue.
  • If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.

Parameters ​

ParameterTypeDescription
clientClient-
parameters{ expand?: | "properties" | string & object | ("properties" | string & object)[]; issueIdOrKey: string; maxResults?: number; startAt?: number; startedAfter?: number; startedBefore?: number; }-
parameters.expand?| "properties" | string & object | ("properties" | string & object)[]Use expand to include additional information about worklogs in the response. This parameter acceptsproperties, which returns worklog properties.
parameters.issueIdOrKey?stringThe ID or key of the issue.
parameters.maxResults?numberThe maximum number of items to return per page.
parameters.startAt?numberThe index of the first item to return in a page of results (page offset).
parameters.startedAfter?numberThe worklog start date and time, as a UNIX timestamp in milliseconds, after which worklogs are returned.
parameters.startedBefore?numberThe worklog start date and time, as a UNIX timestamp in milliseconds, before which worklogs are returned.
options?RequestOptions-

Returns ​

Promise<{ [key: string]: unknown; maxResults?: number; startAt?: number; total?: number; worklogs?: object[]; }>