Skip to content

Function: getAuditRecords() ​

ts
function getAuditRecords(
   client, 
   parameters?, 
   options?
): Promise<{
[key: string]: unknown;
  limit?: number;
  offset?: number;
  records?: object[];
  total?: number;
}>;

Defined in: src/cloud/api/auditRecords.ts:28

Returns a list of audit records. The list can be filtered to include items:

  • Where each item in filter has at least one match in any of these fields:

    • summary
    • category
    • eventSource
    • objectItem.name If the object is a user, account ID is available to filter.
    • objectItem.parentName
    • objectItem.typeName
    • changedValues.changedFrom
    • changedValues.changedTo
    • remoteAddress

    For example, if filter contains man ed, an audit record containing summary": "User added to group" and "category": "group management" is returned.

  • Created on or after a date and time.

  • Created or or before a date and time.

Permissions required:Administer Jira global permission.

Parameters ​

ParameterTypeDescription
clientClient-
parameters?{ filter?: string; from?: string; limit?: number; offset?: number; to?: string; }-
parameters.filter?stringThe strings to match with audit field content, space separated.
parameters.from?stringThe date and time on or after which returned audit records must have been created. If to is provided from must be before to or no audit records are returned.
parameters.limit?numberThe maximum number of results to return.
parameters.offset?numberThe number of records to skip before returning the first result.
parameters.to?stringThe date and time on or before which returned audit results must have been created. If from is provided to must be after from or no audit records are returned.
options?RequestOptions-

Returns ​

Promise<{ [key: string]: unknown; limit?: number; offset?: number; records?: object[]; total?: number; }>