Get audit records

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"}]}]}

Responses

🟢200Returned if the request is successful.

application/json

Body

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if: * the user does not have the required permissions. * all Jira products are on free plans. Audit logs are available when at least one Jira product is on a paid plan.

Request

Responses