Skip to content

Function: updateWorklog() ​

ts
function updateWorklog(
   client, 
   parameters, 
   options?
): Promise<{
[key: string]: unknown;
  author?: {
   [key: string]: unknown;
     active?: boolean;
     avatarUrls?: Record<string, string>;
     displayName?: string;
     emailAddress?: string;
     key?: string;
     name?: string;
     self?: string;
     timeZone?: string;
  };
  comment?: string;
  created?: string;
  id?: string;
  issueId?: string;
  self?: string;
  started?: string;
  timeSpent?: string;
  timeSpentSeconds?: number;
  updateAuthor?: {
   [key: string]: unknown;
     active?: boolean;
     avatarUrls?: Record<string, string>;
     displayName?: string;
     emailAddress?: string;
     key?: string;
     name?: string;
     self?: string;
     timeZone?: string;
  };
  updated?: string;
  visibility?: {
   [key: string]: unknown;
     type?: "role" | "group" | string & object;
     value?: string;
  };
}>;

Defined in: src/server/api/issues.ts:1166

Updates an existing worklog entry. Note that:

  • Fields possible for editing are: comment, visibility, started, timeSpent and timeSpentSeconds.
  • Either timeSpent or timeSpentSeconds can be set.
  • Fields which are not set will not be updated.
  • For a request to be valid, it has to have at least one field change.

Parameters ​

ParameterTypeDescription
clientClient-
parameters{ adjustEstimate?: string; body?: { author?: { active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; comment?: string; created?: string; id?: string; issueId?: string; self?: string; started?: string; timeSpent?: string; timeSpentSeconds?: number; updateAuthor?: { active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; updated?: string; visibility?: { type?: "role" | "group" | string & object; value?: string; }; }; id: string; issueIdOrKey: string; newEstimate?: string; }-
parameters.adjustEstimate?stringAllows you to provide specific instructions to update the remaining time estimate of the issue. Valid values are: new, leave, auto
parameters.body?{ author?: { active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; comment?: string; created?: string; id?: string; issueId?: string; self?: string; started?: string; timeSpent?: string; timeSpentSeconds?: number; updateAuthor?: { active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; updated?: string; visibility?: { type?: "role" | "group" | string & object; value?: string; }; }-
parameters.body.author?{ active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }-
parameters.body.author.active?boolean-
parameters.body.author.avatarUrls?Record<string, string>-
parameters.body.author.displayName?string-
parameters.body.author.emailAddress?string-
parameters.body.author.key?string-
parameters.body.author.name?string-
parameters.body.author.self?string-
parameters.body.author.timeZone?string-
parameters.body.comment?string-
parameters.body.created?string-
parameters.body.id?string-
parameters.body.issueId?string-
parameters.body.self?string-
parameters.body.started?string-
parameters.body.timeSpent?string-
parameters.body.timeSpentSeconds?number-
parameters.body.updateAuthor?{ active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }-
parameters.body.updateAuthor.active?boolean-
parameters.body.updateAuthor.avatarUrls?Record<string, string>-
parameters.body.updateAuthor.displayName?string-
parameters.body.updateAuthor.emailAddress?string-
parameters.body.updateAuthor.key?string-
parameters.body.updateAuthor.name?string-
parameters.body.updateAuthor.self?string-
parameters.body.updateAuthor.timeZone?string-
parameters.body.updated?string-
parameters.body.visibility?{ type?: "role" | "group" | string & object; value?: string; }-
parameters.body.visibility.type?"role" | "group" | string & object-
parameters.body.visibility.value?string-
parameters.id?stringId of the worklog to be updated
parameters.issueIdOrKey?stringA string containing the issue id or key the worklog belongs to
parameters.newEstimate?stringRequired when 'new' is selected for adjustEstimate
options?RequestOptions-

Returns ​

Promise<{ [key: string]: unknown; author?: { [key: string]: unknown; active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; comment?: string; created?: string; id?: string; issueId?: string; self?: string; started?: string; timeSpent?: string; timeSpentSeconds?: number; updateAuthor?: { [key: string]: unknown; active?: boolean; avatarUrls?: Record<string, string>; displayName?: string; emailAddress?: string; key?: string; name?: string; self?: string; timeZone?: string; }; updated?: string; visibility?: { [key: string]: unknown; type?: "role" | "group" | string & object; value?: string; }; }>