swsd_get_record_audits
Read-onlyIdempotent
Retrieve audit history for SWSD records: each entry shows action, message, user, and timestamp to track changes.
Instructions
List the audit log for a SWSD record. Each audit entry captures one change: action ("Update"/"Create"/"Delete"), message ("State changed from New to Assigned"), the user who performed it, and the timestamp. Use this to answer "who changed this ticket?" or "what happened since I last looked?". Cheaper than swsd_get_incident with detail_level=long when you only need the audit history. object_type accepts incidents, problems, changes, releases, solutions, hardwares, other_assets.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_type | Yes | The SWSD record type to fetch audits for. Use 'incidents' for tickets, 'solutions' for KB articles, etc. | |
| id | Yes | Record id. When object_type is "incidents" or "solutions", accepts either the internal id (>=7 digits) or the human-facing number (<=6 digits / <=4 digits respectively). Other object types require the internal id. | |
| page | No | Page number (1-indexed). | |
| per_page | No | Audits per page (1-100). Older records may have hundreds of audit entries; default 25 is enough for "recent activity" reads. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| audits | Yes | ||
| pagination | Yes |