List audit records for a user

The response will include audit records with changes that are made to the identified user not changes made by the identified user.

The returned records are sorted by the execution_time from newest to oldest.

See Cursor-based pagination for instructions on how to paginate through the result set.

For more information see the Audit API Document.

Scoped OAuth requires: audit_records.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Query Parameters

limit?integer

The minimum of the limit parameter used in the request or the maximum request size of the API.

cursor?string

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.

since?string

The start of the date range over which you want to search. If not specified, defaults to now() - 24 hours (past 24 hours)

Formatdate-time

until?string

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.

Formatdate-time

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Response Body

`application/json`

curl -X GET "https://example.com/users/{id}/audit/records" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json"

{  "records": [    {      "id": "PD_ADD_HIGH_URGENCY_NOTIFICATION",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "references": [          {            "added": [              {                "id": "PD_NOTIFICATION_RULE_HIGH",                "summary": "High Urgency (Email: Default)",                "type": "assignment_notification_rule_reference"              }            ],            "name": "notification_rules"          }        ],        "resource": {          "id": "PD_USER_999",          "summary": "Test User",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER_999",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.343Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_ADD_HIGH_URGENCY_EMAIL_CONTACT",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "fields": [          {            "name": "start_delay_in_minutes",            "value": "0"          },          {            "name": "urgency",            "value": "high"          }        ],        "references": [          {            "added": [              {                "id": "PD_CONTACT_METHOD",                "summary": "Default",                "type": "email_contact_method_reference"              }            ],            "name": "contact_method"          }        ],        "resource": {          "id": "PD_NOTIFICATION_RULE_HIGH",          "summary": "High Urgency (Email: Default)",          "type": "assignment_notification_rule_reference"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.343Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_ADD_LOW_URGENCY_EMAIL_RULE",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "fields": [          {            "name": "start_delay_in_minutes",            "value": "0"          },          {            "name": "urgency",            "value": "low"          }        ],        "references": [          {            "added": [              {                "id": "PD_CONTACT_METHOD",                "summary": "Default",                "type": "email_contact_method_reference"              }            ],            "name": "contact_method"          }        ],        "resource": {          "id": "PD_NOTIFICATION_RULE_LOW",          "summary": "Low Urgency (Email: Default)",          "type": "assignment_notification_rule_reference"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.335Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_ADD_LOW_URGENCY_EMAIL_CONTACT",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "references": [          {            "added": [              {                "id": "PD_NOTIFICATION_RULE_LOW",                "summary": "Low Urgency (Email: Default)",                "type": "assignment_notification_rule_reference"              }            ],            "name": "notification_rules"          }        ],        "resource": {          "id": "PD_USER_999",          "summary": "Test User",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER_999",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.335Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_EMAIL_CONTACT_FOR_USER",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "fields": [          {            "name": "label",            "value": "Default"          },          {            "name": "type",            "value": "email_contact_method"          },          {            "name": "address",            "value": "testuser@testabc123.com"          }        ],        "resource": {          "id": "PD_CONTACT_METHOD",          "summary": "Default",          "type": "email_contact_method_reference"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.327Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_ADD_EMAIL_CONTACT_TO_USER",      "action": "update",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "references": [          {            "added": [              {                "id": "PD_CONTACT_METHOD",                "summary": "Default",                "type": "email_contact_method_reference"              }            ],            "name": "contact_methods"          }        ],        "resource": {          "id": "PD_USER_999",          "summary": "Test User",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER_999",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:32.327Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    },    {      "id": "PD_CREATE_USER",      "action": "create",      "actors": [        {          "id": "PDUSER",          "summary": "John Snow",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER123",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER123"        }      ],      "details": {        "fields": [          {            "name": "name",            "value": "Test User"          },          {            "name": "role",            "value": "user"          },          {            "name": "email",            "value": "testuser@testabc123.com"          },          {            "name": "time_zone",            "value": "America/New_York"          },          {            "name": "description",            "value": null          },          {            "name": "job_title",            "value": null          },          {            "name": "color",            "value": "brown"          }        ],        "resource": {          "id": "PD_USER_999",          "summary": "Test User",          "type": "user_reference",          "self": "https://api.pagerduty.com/users/PD_USER_999",          "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"        }      },      "execution_context": {        "request_id": "a68929b2-d0f4-4def-b1d2-6bb744c44e3d"      },      "execution_time": "2021-01-05T15:17:31.708Z",      "method": {        "type": "browser"      },      "root_resource": {        "id": "PD_USER_999",        "summary": "Test User",        "type": "user_reference",        "self": "https://api.pagerduty.com/users/PD_USER_999",        "html_url": "https://mydomain.pagerduty.com/users/PD_USER_999"      }    }  ],  "limit": 10,  "next_cursor": null}

List audit records for a user

Authorization

Path Parameters

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`