Get audit records - JIRA 7.6.1

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.

{ "offset": 0, "limit": 1000, "total": 1, "records": [ { "id": 1, "summary": "User created", "remoteAddress": "192.168.1.1", "authorKey": "administrator", "authorAccountId": "5ab8f18d741e9c2c7e9d4538", "created": "2014-03-19T18:45:42.967+0000", "category": "user management", "eventSource": "Jira Connect Plugin", "description": "Optional description", "objectItem": { "id": "user", "name": "user", "typeName": "USER", "parentId": "1", "parentName": "Jira Internal Directory" }, "changedValues": [ { "fieldName": "email", "changedFrom": "user@atlassian.com", "changedTo": "newuser@atlassian.com" } ], "associatedItems": [ { "id": "jira-software-users", "name": "jira-software-users", "typeName": "GROUP", "parentId": "1", "parentName": "Jira Internal Directory" } ] } ] }

Request

Query Params

offset

integer

optional

The number of records to skip before returning the first result.

limit

integer

optional

The maximum number of results to return.

filter

string

optional

The strings to match with audit field content, space separated.

from

string

optional

The 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.

string

optional

The 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.

Responses

🟢200Returned if the request is successful.

application/json

Body

Container for a list of audit records.

limit

integer <int32>

read-onlyoptional

The requested or default limit on the number of audit items to be returned.

offset

integer <int32>

read-onlyoptional

The number of audit items skipped before the first item in this list.

records

array[object (AuditRecordBean) {11}]

read-onlyoptional

The list of audit items.

associatedItems

array[object (AssociatedItemBean) {5}]

read-onlyoptional

The list of items associated with the changed record.

authorKey

string

read-onlyoptional

Deprecated, use authorAccountId instead. The key of the user who created the audit record.