List Audit Events

Beta

GET/v1/core/audit-events

This endpoint is idempotent. Learn more

Returns a paginated list of audit events for the current account.

cursoroptional string

Query parameter: cursor for List Audit Events

limitoptional integer

Query parameter: limit for List Audit Events

qoptional string

Query parameter: q for List Audit Events

start_dateoptional string (date-time)

Start of date range for occurred_at.

end_dateoptional string (date-time)

End of date range for occurred_at.

resource_typeoptional stringenumValues:accountactorentity

Resource type of the audited entity.

resource_idoptional string

Audited resource ID.

actor_idoptional string

Actor ID.

actionoptional stringenumValues:createupdatedelete

Audit action.

account_idoptional string

Actor home account ID.

include[]optional arrayenumValues:actorchangesmetadata

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

objectstringenumValues:list

Object type for AuditEvent list

page_infoobject

Pagination metadata for AuditEvent list

next_cursorstringnullable

Cursor to fetch the next page, null if no more pages.

prev_cursorstringnullable

Cursor to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Array of AuditEvent resources in this page

idstring

Audit event ID.

objectstringenumValues:audit_event

Resource type identifier.

actionstringenumValues:createupdatedelete

Mutation type.

resource_typestringenumValues:accountactorentity

Resource type of the audited entity.

resource_idstring

Audited resource ID.

actorobjectExpandablenullable

Actor who performed the mutation.

idstring

Actor ID.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

namestringnullable

Display name.

handlestringnullable

Human-readable handle (email for users, redacted value for API keys, slug for agents).

roleobjectnullable

Assigned role.

Always returned as null in this endpoint.

changesobjectExpandablenullable

Field-level changes recorded for this event.

objectstringenumValues:list

Object type for AuditFieldChange list

page_infoobject

Pagination metadata for AuditFieldChange list

next_cursorstringnullable

Cursor to fetch the next page, null if no more pages.

prev_cursorstringnullable

Cursor to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Array of AuditFieldChange resources in this page

fieldstring

Name of the changed field.

old_valueobject

Previous value as a JSON fragment. Null for creation events.

new_valueobject

New value as a JSON fragment. Null for deletion events.

metadataobjectExpandable

Arbitrary JSON metadata for the mutation (e.g. reason, source, tags).

request_idstringnullable

Originating HTTP request ID.

idempotency_keystringnullable

Idempotency key of the originating request.

source_ipstringnullable

Originating client IP address.

occurred_atstring (date-time)

When the audited mutation occurred.

created_atstring (date-time)

When the audit event record was created.

Responses

200

Successful response for List Audit Events

List Audit Events

curl API_HOST/v1/core/audit-events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1"

curl API_HOST/v1/core/audit-events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1"

200 example

{
  "object": "list",
  "page_info": {
    "next_cursor": "ae_01gq7s3f2m0y9h2t7z1w7q3v9k",
    "prev_cursor": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "ae_01gq7s3f2m0y9h2t7z1w7q3v9k",
      "object": "audit_event",
      "action": "update",
      "resource_type": "user",
      "resource_id": "us_01gf7a8200e9pvbd6bgyq395ae",
      "actor": {
        "id": "us_01gf7a8200e9pvbd6bgyq395ae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "changes": {
        "object": "list",
        "page_info": {
          "next_cursor": null,
          "prev_cursor": null,
          "has_next_page": false,
          "has_prev_page": false
        },
        "data": [
          {
            "field": "email",
            "old_value": "old@example.com",
            "new_value": "new@example.com"
          }
        ]
      },
      "metadata": {
        "reason": "operator override"
      },
      "request_id": "req_01gq7s3f2m0y9h2t7z1w7q3v9k",
      "idempotency_key": null,
      "source_ip": "198.51.100.8",
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_cursor": "ae_01gq7s3f2m0y9h2t7z1w7q3v9k",
    "prev_cursor": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "ae_01gq7s3f2m0y9h2t7z1w7q3v9k",
      "object": "audit_event",
      "action": "update",
      "resource_type": "user",
      "resource_id": "us_01gf7a8200e9pvbd6bgyq395ae",
      "actor": {
        "id": "us_01gf7a8200e9pvbd6bgyq395ae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "changes": {
        "object": "list",
        "page_info": {
          "next_cursor": null,
          "prev_cursor": null,
          "has_next_page": false,
          "has_prev_page": false
        },
        "data": [
          {
            "field": "email",
            "old_value": "old@example.com",
            "new_value": "new@example.com"
          }
        ]
      },
      "metadata": {
        "reason": "operator override"
      },
      "request_id": "req_01gq7s3f2m0y9h2t7z1w7q3v9k",
      "idempotency_key": null,
      "source_ip": "198.51.100.8",
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z"
    }
  ]
}

List Audit Events

Query Parameters

Returns

Responses