1. Docs
  2. API Reference
  3. Delete a saved audit-log view

Delete a saved audit-log view

DELETE/portal/v1/me/audit-views/{surface}/{name}

Deletes the calling admin's saved view identified by the :surface and :name path params. :surface must be admin or identities (otherwise 400). Idempotent — removing a view that doesn't exist is a no-op and still returns 204.

Authentication

Bearer TokenAuthorization

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

Path Parameters

surfacestring Required
namestring Required

Responses

Idempotent — removing a name that doesn't exist returns 204 with no error.

application/json

  • errorApiErrorBodyDto*

application/json

  • errorApiErrorBodyDto*
Request
curl -X DELETE "https://auth.canopy-io.com/portal/v1/me/audit-views/value/value" \
  -H "Authorization: Bearer $CANOPY_TOKEN"
Response
HTTP/1.1 204 Idempotent — removing a name that doesn't exist returns 204 with no error.

(empty body)
 Related endpoints
GETList saved audit-log views for the current admin
POSTCreate or replace a saved audit-log view
 Was this page helpful?

Tell us how we can improve this guide.

Canopy