Skip to main content
Audit endpoints let you review actions across the workspace, with optional filters for users, actions, artifact types, and time ranges.

Basic request and response

Query the workspace audit log with GET /api/v1/app/audit.
curl "https://{BASE_URL}/api/v1/app/audit?start_date=1738291200&end_date=1738972800&include=User&artifact_types=File,URL&page=1&page_size=50" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
[]

Project audit log

curl "https://{BASE_URL}/api/v1/app/project/{projectID}/audit?start_date=1738291200&end_date=1738972800&artifact_types=File,URL&page=1&page_size=50" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
[]

Query parameters

  • start_date, end_date: Unix timestamps for the time window.
  • include: Optional entity filter (for example User).
  • artifact_types: Optional comma-separated artifact type filter.
  • page, page_size: Pagination controls.

Errors and edge cases

  • 400: invalid time range or filters.
  • 403: insufficient permissions.