PAGERDUTY_GET_AUDIT_RECORDS

Retrieves a list of audit records from the PagerDuty system. This endpoint allows users to access logs of configuration changes made to PagerDuty resources, such as account objects. The records are sorted by execution time, with the newest records appearing first. This tool is particularly useful for tracking and reviewing changes, conducting security audits, or generating reports on system modifications. It provides a comprehensive view of who made what changes and when, enhancing transparency and accountability within the organization. The endpoint supports pagination and date range filtering to manage large volumes of audit data effectively.

Available from 1 provider (1 remote)

Input Schema

            {
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "description": "The minimum of the `limit` parameter used in the request or the maximum request size of the API. "
    },
    "since": {
      "type": "string",
      "title": "Since",
      "description": "The start of the date range over which you want to search. If not specified, defaults to `now() - 24 hours` (past 24 hours) "
    },
    "until": {
      "type": "string",
      "title": "Until",
      "description": "The end of the date range over which you want to search. If not specified, defaults to `now()`. May not be more than 31 days after `since`. "
    },
    "cursor": {
      "type": "string",
      "title": "Cursor",
      "description": "Optional parameter used to request the \"next\" set of results from an API.  The value provided here is most commonly obtained from the `next_cursor` field of the previous request.  When no value is provided, the request starts at the beginning of the result set.  "
    },
    "actions": {
      "enum": [
        "create",
        "update",
        "delete"
      ],
      "type": "string",
      "title": "Actions",
      "description": "Action filter"
    },
    "actor_id": {
      "type": "string",
      "title": "Actor Id",
      "description": "Actor Id filter. Must be qualified by providing the `actor_type` param."
    },
    "actor_type": {
      "enum": [
        "user_reference",
        "api_key_reference",
        "app_reference"
      ],
      "type": "string",
      "title": "Actor Type",
      "description": "Actor type filter."
    },
    "method_type": {
      "enum": [
        "browser",
        "oauth",
        "api_token",
        "identity_provider",
        "other"
      ],
      "type": "string",
      "title": "Method Type",
      "description": "Method type filter."
    },
    "root__resource__types": {
      "enum": [
        "users",
        "teams",
        "schedules",
        "escalation_policies",
        "services"
      ],
      "type": "string",
      "title": "Root  Resource  Types",
      "description": "Resource type filter for the root_resource."
    },
    "method_truncated_token": {
      "type": "string",
      "title": "Method Truncated Token",
      "description": "Method truncated_token filter. Must be qualified by providing the `method_type` param. "
    }
  }
}