Audit

The Audit object provides a detailed record of a specific event that occurred within the platform.

This object contains the following attributes:

Field	Type	Description
id	string, core	(Read-only) A unique identifier for the audit record. Note that no nesting exists for this identifier.
event	string, core	The event code. Format: {platform/extension}.{module/extension name}.{object}.{action}
summary	string, core	A summary of the audit record.
details	string, core	The audit details template. Any document property may be used as a placeholder.
actor	object, core	(Read-only) Represents the auditRecordActor object containing information about the actor who has triggered an event. Example: { "id": "USR-2311-4038", "name": "Will Smith", "icon": "/public/users/usr-2311-4038.jpg", "account": { "id": "ACC-8989-32321", "name": "AdAstra Flex", "icon": "/public/accounts/acc-8989-32321.jpg", } }
object	object, core	Represents the auditRecord object for which an event has been triggered. Example: { "id": "ORD-3568-4038-2535", "type": "order", "icon": null, "objectType": "Order" }
timestamp	dateTime, core	(Read-only) The timestamp of the event.
type	enum, core	(Read-only) The visibility of the audit record. Allowed values are public or private.
request	object, core	Represents the auditRecordRequest object, which defines the request for technical data. Example: { "api": { "ip": "192.168.2.2", "geolocation": { "countryCode": "ES", "countryName": "Spain", "region": "Catalonia" }, "userAgent": "Chrome" } "worker": { "workerName": null } "log": { "correlationId": "some-app-insights-id" } }
documents	object	Represents the auditRecordDocument containing a collection of linked eventRecord objects. Example: { "order_01": { "id": "ORD-3568-4038-2535", "type": "Purchase", "status": "Completed" } "extraData_01" { "extra_prop_01": "Some value that does not exist in order" } }
viewers	object, core	(Read-only) Represents the auditRecordViewer object containing the list of accounts with access to audit records. Example: [ { "id": "ACC-3408-7241", "name": "MPT Commerce e2e client", "type": "Client", "icon": "/v1/accounts/accounts/ACC-3408-7241/icon" }, { "id": "ACC-1675-9721", "name": "Adobe", "type": "Vendor", "icon": "/v1/accounts/accounts/ACC-1675-9721/icon" } ]

Example

AUDIT OBJECT

{
    "event": "platform.commerce.order.created",
    "summary": "Order Created",
    "details": "The order ORD-1208-2301-8479 has been successfully created by Balint Polgar and is now in the platform.",
    "object": {
        "id": "ORD-1208-2301-8479",
        "name": "ORD-1208-2301-8479",
        "objectType": "Order"
    },
    "timestamp": "2024-10-21T10:03:00.800Z",
    "actor": {
        "id": "USR-0556-8733",
        "name": "Balint Polgar",
        "icon": "/v1/accounts/users/USR-0556-8733/icon",
        "account": {
            "id": "ACC-3408-7241",
            "name": "MPT_QA_STATIC Commerce e2e client",
            "icon": "/v1/accounts/accounts/ACC-3408-7241/icon",
            "accountType": "Client"
        }
    },
    "type": "Public",
    "request": {
        "api": {
            "ip": "92.26.0.92",
            "geolocation": {
                "countryCode": "GB",
                "countryName": "United Kingdom",
                "region": "Scotland"
            },
            "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:131.0) Gecko/20100101 Firefox/131.0"
        }
    },
    "documents": {
        "order": {
            "id": "ORD-1208-2301-8479",
            "href": "/commerce/orders/ORD-1208-2301-8479",
            "type": "Termination",
            "status": "Draft"
        },
        "actor": {
            "id": "USR-0556-8733",
            "name": "Balint Polgar",
            "icon": "/v1/accounts/users/USR-0556-8733/icon",
            "account": {
                "id": "ACC-3408-7241",
                "name": "MPT_QA_STATIC Commerce e2e client",
                "icon": "/v1/accounts/accounts/ACC-3408-7241/icon",
                "accountType": "Client"
            }
        }
    },
    "viewers": [
        {
            "id": "ACC-3408-7241",
            "name": "MPT_QA_STATIC Commerce e2e client",
            "type": "Client",
            "icon": "/v1/accounts/accounts/ACC-3408-7241/icon"
        },
        {
            "id": "ACC-1675-9721",
            "name": "Adobe",
            "type": "Vendor",
            "icon": "/v1/accounts/accounts/ACC-1675-9721/icon"
        }
    ],
    "id": "AUD-0391-8050-9033-9920"
}