GuidesAPI DocsChangelogMy AppsSeismic Exchange
API Docs

Create audit data export task

post
https://api.seismic.com/pas/v1/audits/query-tasks

Starts an asynchronous task that exports audit records for the
authenticated user's tenant to a downloadable CSV (comma-separated values)
file. Accepts the same filters as the synchronous query endpoint: audit
domains, actor IDs, impersonation, resource type/name, and a
Unix-timestamp time range.

Tenant is derived from the user token — do not pass tenant as a path or
query parameter.

Asynchronous flow: This endpoint returns immediately with 202 Accepted and a taskId. Poll GET /v1/audits/query-tasks/{taskId} until
status becomes Success (or Failed), then call
GET /v1/audits/query-tasks/{taskId}/download to retrieve the CSV result.
Use this export flow instead of the synchronous /v1/audits/records query
when you need the full result set rather than a single page.

Audit domain hierarchy: Each value in auditDomains automatically
expands to include all child domains, and each value in
ignoredAuditDomains excludes a domain and all of its descendants.
Exclusion takes precedence over inclusion.

Rate limit: Tier 2 (60 requests/minute per tenant).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Filters and pagination controlling which audit records are exported.

auditDomains
array of strings

Optional filter by audit domain(s). When omitted, records from all
domains are exported. When provided, must contain at least one value
and all values must be recognized domain names (case-insensitive).

Hierarchy expansion: If the specified domain has child domains, it
automatically expands to include all of them. For example,
"Security & Permissions" also exports records for
"Security & Permissions / SSO Settings",
"Security & Permissions / Watermark Templates", and all other
sub-domains. If the specified domain is already a leaf (no children),
only records for that exact domain are exported.

Valid values:

  • People
  • Security & Permissions
  • Security & Permissions / Password Policy
  • Security & Permissions / Permissions
  • Security & Permissions / SSO Settings
  • Security & Permissions / LiveSend Permissions
  • Security & Permissions / Network Security
  • Security & Permissions / Certificate Management
  • Security & Permissions / Privacy Management
  • Security & Permissions / Privacy Management / Data Privacy Settings
  • Security & Permissions / Privacy Management / User Data
  • Security & Permissions / Privacy Management / Contact Management
  • Security & Permissions / Privacy Management / Contact Communication
  • Security & Permissions / Privacy Management / User Management
  • Security & Permissions / Watermark Templates
  • Security & Permissions / Data Management
  • Security & Permissions / Virus Scan
  • Security & Permissions / Impersonation Settings
  • External Connections
  • External Connections / External Content
  • External Connections / SQL Connections
  • External Connections / DataSource Settings
  • External Connections / External Systems
  • Application Settings
  • Application Settings / System Options
  • Application Settings / Common Settings
  • Application Settings / Home Page & Page Settings
  • Application Settings / Welcome Email
  • Application Settings / Web Settings
  • Application Settings / LiveDoc Settings
  • Application Settings / WorkSpace Settings
  • Application Settings / DocCenter Settings
  • Application Settings / iOS Application
  • Application Settings / Android Application
  • Application Settings / Desktop Sync Application
  • Application Settings / Salesforce Application
  • Application Settings / SharePoint Application
  • Application Settings / Windows 8 Application
  • Application Settings / Plugin Application
  • Application Settings / Programs Settings
  • Application Settings / Custom Content Type Settings
  • Application Settings / LiveSend Viewer
  • Application Settings / Microapp Settings
  • Application Settings / Predictive Content
  • Application Settings / Embedded Applications
  • Application Settings / Engagement Center
  • Application Settings / Meeting Settings
  • Application Settings / Digital Sales Room Settings
  • General Settings
  • General Settings / Brand Management
  • General Settings / Custom Properties
  • General Settings / Notification Settings
  • General Settings / Search Settings
  • General Settings / Email Settings
  • General Settings / Content Id Settings
  • General Settings / Font Management
  • General Settings / All TeamSites
  • General Settings / Delivery Options
  • General Settings / Email Design Settings
  • General Settings / Approval Process Settings
  • Manage Apps
  • Manage Apps / My Apps
auditDomains
ignoredAuditDomains
array of strings

Optional list of audit domains to exclude from the export. When omitted
or empty, no domains are excluded. When provided, each value must be
a recognized domain name (case-insensitive).

Hierarchy expansion: A parent domain in this list excludes all
its child domains as well. For example, "Security & Permissions / Privacy Management" also excludes all Privacy Management sub-domains.

Exclusion precedence: If the same domain appears in both
auditDomains and ignoredAuditDomains, it is excluded from results.

Accepts the same valid values as auditDomains.

ignoredAuditDomains
actorIds
array of uuids

Optional filter to export only records where the actor matches one
of the provided IDs. When provided, must contain at least one value.

actorIds
string

Optional filter to export only records where the target resource type
matches this value (case-sensitive exact match). Whitespace is trimmed.

string

Optional filter to export only records where the target resource name
matches this value (case-sensitive exact match). Whitespace is trimmed.

impersonatedBy
array of uuids

Optional filter to export only records where the action was performed
via impersonation by one of the provided actor IDs.

impersonatedBy
timeRange
object

Optional Unix-timestamp (milliseconds) time range filter.

pagination
object

Pagination control applied when collecting records for export.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 4 hours ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 4 hours ago