PEpermit
Audit Logs

List Audit Logs

Changed on
get/v2/pdps/{proj_id}/{env_id}/audit_logs

Request

  • Base URL
    https://api.permit.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Query parameters

pdp_idstring uuid

Filter by pdp config id

usersstring[]

List of user keys or emails to filter by

decisionboolean

Filter by decision result

resourcesstring[]

Filter by resources

tenantstring

Filter by tenant

actionstring

Filter by action

timestamp_frominteger

Filter by timestamp from

timestamp_tointeger

Filter by timestamp to

sort_by'None' | 'timestamp'

An enumeration.

Sort by column

query'check' | 'get_user_permissions' | 'get_authorized_users' | 'none'

Filter audit logs by the type of query that generated them.

Filter by the type of query that generated the audit log.<br />'check' - permit/root, permit/check, permit/bulk<br />'get_user_permissions' - permit/user_permissions<br />'get_authorized_users' - permit/authorized_users, permit/authorized_users_new<br />'none' - All queries

pageinteger

Page number of the results to fetch, starting at 1.

per_pageinteger

The number of results per page (max 100).

Response

Successful Response

total_countinteger required
page_countinteger
pagination_countinteger required

Changes

  • 6a33af02350cRevision changes
    • breaking

      the response property // became optional for the status

    • warning

      added the new GENERIC enum value to the //// response property for the response status

    • info

      added to the // response property anyOf list for the response status

  • 0053b006acecRevision changes
    • info

      added the new optional query request parameter query