Logs

List audit logs

Requires scope: read. Read-only audit trail of state-changing operations, and of requests the API refused with a 4xx once it knew the workspace (category api, action request.refused). A refusal before that, such as a missing or unknown key, is not recorded. The same refusal again (the same key, method, path and code) is recorded at most once a minute, a 429 once a minute per code, and a workspace records at most 30 refusals a minute.

get/v1/logs

Request

  • Base URL: https://api.mails.ai
  • URL: https://api.mails.ai/v1/logs
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size (1–100).

cursorstring

Opaque cursor from a previous page's next_cursor.

categorystring

Filter by audit category.

actionstring

Filter by audit action.

Response

A page of audit log entries.

has_moreboolean required

True when more items follow this page: pass next_cursor as cursor to get them.

next_cursorstring

Pass as cursor to fetch the next page. Absent on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.