AuditLogsReport
Query the Audit Logs Report via the Explore API. Provides information about how Talkdesk systems are being used, by whom, and when. Up to a month of data per request.
Select
The AuditLogsReport is a report view. The component processes the following pseudo-columns server-side; any other WHERE clause conditions are evaluated client-side.
- TimespanFrom supports the following operator: >=
- TimespanTo supports the following operator: <
- Timezone supports the following operator: =
If TimespanFrom and TimespanTo are omitted, the component defaults the time range to the last 31 days.
For example, the following query is processed server-side:
SELECT * FROM AuditLogsReport WHERE TimespanFrom >= '2025-01-01' AND TimespanTo < '2025-02-01'
Columns
| Name | Type | References | Description |
| ActorId [KEY] | String | The unique identifier of the actor who performed the operation. | |
| GeneratorName | String | The name of the service that generated the audit log entry. | |
| IpAddresses | String | The IP addresses associated with the audit log action. | |
| Operation | String | The operation that was performed. | |
| PlatformTid | String | The platform transaction ID for the operation. | |
| ResourceId | String | The resource that the operation was performed on. | |
| OperationStatus | String | The status of the operation. Example values: success. | |
| UserAgent | String | The user agent string of the client that performed the operation. | |
| Timestamp | Datetime | The date and time when the operation was performed. | |
| UserId | String |
Users.Id | The unique identifier of the user who performed the operation. |
| AgentName | String | The name of the agent who performed the operation. | |
| AgentEmail | String | The email address of the agent who performed the operation. | |
| Resource | String | The resource associated with the audit log entry. | |
| PreviousValue | String | The previous value before the operation was performed. | |
| UpdatedValue | String | The updated value after the operation was performed. |
Pseudocolumns
Pseudocolumn fields are used in the WHERE clause of SELECT statements and offer more granular control over the data returned from the data source.
| Name | Type | Description | |
| TimespanFrom | Datetime | The start date for the report timespan. | |
| TimespanTo | Datetime | The end date for the report timespan. | |
| Timezone | String | The IANA timezone for the report timespan. |