Audit

Search entity audit logs

Search entity audit logs from your Port account using a structured filterQuery (also viewable in Port's UI). For blueprint, action, run, and other resource types, use Get audit logs instead.<br/><br/>Non-admin users must have the read:audit-log scope. Access may be limited to audit logs for entities and action runs they are allowed to see.

post/v1/audit-logs/entities

Request

  • Base URL: https://api.port.io
  • URL: https://api.port.io/v1/audit-logs/entities
  • Auth: API key in header Authorization

Query parameters

historicalDataboolean

When true, entity and blueprint filters in filterQuery use identifiers. When false (default), they use internal IDs.

string
OR
string[]

Optional fields to return per log, e.g. diff, context, trigger, status, message.

Request body

limitinteger

Maximum number of logs to return. Defaults to 1000 (maximum 1000). Prefer reasonable values, especially alongside broad date filters, since very broad queries may be slow on large accounts.

offsetinteger

Number of logs to skip, for paginating beyond the first limit results.

Response

Default Response

Changes

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