Audit Logs Actions
https://api.losant.com/orgs/ORG_ID
/audit-logs
Below are the various requests that can be performed against the Audit Logs resource, as well as the expected parameters and the potential responses.
Get
Returns the audit logs for the organization
Method And Url
GET https://api.losant.com/orgs/ORG_ID
/audit-logs
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Organization, all.Organization.read, all.User, all.User.read, auditLogs.*, or auditLogs.get.
Request Path Components
Path Component | Description | Example |
---|---|---|
ORG_ID | ID associated with the organization | 575ed6e87ae143cd83dc4aa8 |
Request Query Parameters
Name | Required | Description | Default | Example |
---|---|---|---|---|
sortField | N | Field to sort the results by. Accepted values are: creationDate, responseStatus, actorName | creationDate | sortField=creationDate |
sortDirection | N | Direction to sort the results by. Accepted values are: asc, desc | desc | sortDirection=asc |
page | N | Which page of results to return | 0 | page=0 |
perPage | N | How many items to return per page | 100 | perPage=10 |
start | N | Start of time range for audit log query | start=1465790400000 | |
end | N | End of time range for audit log query | end=1465790400000 | |
auditLogFilter | N | Filters for the audit log query. See Audit Log Filter for more details. | auditLogFilter[primaryTarget][0][type]=Dashboard&auditLogFilter[primaryTarget][1][type]=Application&auditLogFilter[primaryTarget][1][id]=575ec8687ae143cd83dc4a97&auditLogFilter[actor][0][type]=User&auditLogFilter[actor][0][id]=575ed70c7ae143cd83dc4aa9 |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X GET \
https://api.losant.com/orgs/ORG_ID/audit-logs
Successful Responses
Code | Type | Description |
---|---|---|
200 | Audit Logs | Collection of audit logs |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if organization was not found |
Was this page helpful?
Still looking for help? You can also search the Losant Forums or submit your question there.