Export Audit Records

post

{protocol}://{server}/api/admin/group/v1beta/accounts/{accountId}/audit-records:export

This API requires the Account Administrator role.

Exports the audit records within the date-time range in CSV format.

A maximum of 1000 records can be exported for a given date-time range per request.

If the number of records within a date-time range exceeds the maximum then this API will
return a HTTP 400 Bad Request. This response will contain:

A human readable message explaining the issue.
A unique error code that a client can use to identify the issue.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

accountId

string

required

length between 6 and 6

^[a-zA-Z]{6}$

The unique 6 character internal id that represents the customer account.

Query Params

orderBy

string

length between 4 and 23

Field name on which sorting needs to be performed. The possible fields
you ordered on are date (date of audit record) and author.
Field Names are case-sensitive (should be written as it is in description). The default sorting order is descending. To specify ascending order, a suffix " asc" should be added. For example, "date asc" for ascending or "date desc" for descending".

Body Params

The filter to be applied when searching for audit records.

startDate

date-time

required

The starting datetime to use when searching for audit records (in ISO 8601 format including timezone, 'yyyy-MM-dd'T'HH:mm:ss[.SSS]Z').

endDate

date-time

required

The ending datetime to use when searching for audit records (in ISO 8601 format including timezone, 'yyyy-MM-dd'T'HH:mm:ss[.SSS]Z').

author

string

length ≤ 255

^[a-zA-Z0-9@._-]+$

The ID of the author who changed the auditable object. This can be a user within the system or an automated app.

event

string

enum

This field indicates the type of event that occurred on the auditable object.

An explanation of the values is listed below:

CREATED - A new auditable object was created.
UPDATED - An existing auditable object was updated.
DELETED - An existing auditable object was deleted.

Allowed:

type

string

enum

required

The type of auditable object.

Accepted values:

GROUP

Allowed:

ipAddress

string

length ≤ 15

The originating IP Address of the author who changed the auditable object.

searchKeyword

string

length ≤ 255

Keyword to search for across all the audit records.

Headers

string

enum

Defaults to application/problem+json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

text/csv

application/problem+json

200OK

400BadRequest

401Unauthorized

403Forbidden

404Not Found

500All other application errors