PIpixiebrix
activity

GET /api/activity/reports/security/

Changed on

Return security events (recorded by the Record Security Event brick and the policy-driven clipboard/URL-block/file-upload/protected-field enforcers) over the reporting window, newest first, for a member (user) or across one or more groups (groups), else the whole organization. Optional category / severity / action / destination query params filter the list; the response also includes per-category, per-severity, per-action, and top-destination (file-upload report) counts over the full window. Restricted to organization admins/managers or activity & security report viewers, and gated by the activity-tracking flag.

Request

  • Base URL
    https://app.pixiebrix.com
  • Auth
    none declared

Query parameters

organizationstring uuid required

UUID of the organization to scope the report to.

userstring uuid

Optional member UUID to scope the report to one user.

groupsstring[]

Optional group UUIDs to scope the report; repeated (?groups=a&groups=b) or comma-separated (?groups=a,b).

startstring date-time

Optional ISO-8601 start of the report window (inclusive).

endstring date-time

Optional ISO-8601 end of the report window (exclusive).

limitinteger

Optional maximum number of rows to return.

rule_typestring

Filter by rule type, independent of custom rule categories.

categorystring

Optional security-event category to filter the list by.

severity'info' | 'low' | 'medium' | 'high' | 'critical'

Optional security-event severity to filter the list by.

actionstring

Optional graduated-action (monitor/warn/block/softBlock) to filter the list by.

destinationstring

Optional file-upload destination to filter the list by.

precisionstring

Optional Interaction-Matching precision (L0/L1/L2) to filter the list by.

Response

organizationstring uuid required
startstring date-time required
endstring date-time required
events_truncatedboolean required

Changes

  • bde42d847d17Revision changes
    • info

      added the new optional query request parameter rule_type

    • info

      added the required property // to the response with the status (media type: application/json; version=1.0)

    • info

      added the required property // to the response with the status (media type: application/vnd.pixiebrix.api+json; version=1.0)

  • bcc966c3991cRevision changes
    • info

      added the required property // to the response with the status (media type: application/json; version=1.0)

    • info

      added the required property // to the response with the status (media type: application/vnd.pixiebrix.api+json; version=1.0)