1. Docs
  2. API Reference
  3. List saved audit-log views for the current admin

List saved audit-log views for the current admin

GET/portal/v1/me/audit-views

Returns every saved audit-log view the calling admin has created, as a { items } collection. Views are user-scoped (no Account or Application in the path) since an admin reuses them across the Accounts they belong to. Each entry carries name, surface (admin or identities), and a filters snapshot in AuditQueryDto shape. Returns an empty array when the admin has saved none.

Authentication

Bearer TokenAuthorization

JWT access token. Never send alongside X-API-Key: a request carrying both is refused.

Responses

application/json

  • itemsAuditViewResponseDto[]*

application/json

  • errorApiErrorBodyDto*

application/json

  • errorApiErrorBodyDto*

Returned object

AuditViewResponseDtoView all properties on this resource
Request
curl -X GET "https://auth.canopy-io.com/portal/v1/me/audit-views" \
  -H "Authorization: Bearer $CANOPY_TOKEN"
Response
{
  "items": [
    {
      "name": "string",
      "surface": "admin",
      "filters": {}
    }
  ]
}
 Related endpoints
POSTCreate or replace a saved audit-log view
DELETEDelete a saved audit-log view
 Was this page helpful?

Tell us how we can improve this guide.

Canopy