Skip to main content
GET
List snapshot-backed resource activity

Authorizations

​
Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Query Parameters

​
refTypes
enum<string>[]

Optional snapshot ref type filter. Accepts repeated values or a comma-separated list.

Available options:
USERS,
GROUPS,
ROLE_GROUPS,
COMPONENTS,
ENDPOINTS,
TEMPLATES,
SCHEDULE,
EVENTS,
SECRETS,
STORAGE,
FILES,
PREFERENCES,
USER_KEYS,
DATABASES,
AGENTS,
AGENT_PLUGINS,
DATABASE_VIEWS,
COMPONENT_ELEMENT
​
excludeRefTypes
enum<string>[]

Optional snapshot ref types to exclude after refTypes inclusion is applied. Accepts repeated values or a comma-separated list.

Available options:
USERS,
GROUPS,
ROLE_GROUPS,
COMPONENTS,
ENDPOINTS,
TEMPLATES,
SCHEDULE,
EVENTS,
SECRETS,
STORAGE,
FILES,
PREFERENCES,
USER_KEYS,
DATABASES,
AGENTS,
AGENT_PLUGINS,
DATABASE_VIEWS,
COMPONENT_ELEMENT
​
term
string

Optional term matched through the snapshot search vector.

Maximum string length: 100
Example:

"billing"

​
refId
string

Optional exact resource id filter.

Maximum string length: 100
Example:

"11111111-1111-4111-8111-111111111111"

​
createdBy
string

Optional exact creator user id filter.

Maximum string length: 100
Example:

"11111111-1111-4111-8111-111111111111"

​
from
string

Inclusive lower ISO date bound. Overrides since. Exact refId history has no default lower bound.

Example:

"2026-06-29T00:00:00.000Z"

​
to
string

Inclusive upper ISO date bound.

Example:

"2026-06-30T00:00:00.000Z"

​
since
string

Relative lookback such as 24h, 7d, or 30m. Defaults to 24h only for broad browsing without refId.

Maximum string length: 16
Example:

"24h"

​
cursor
string

Pagination cursor returned by the previous response.

Maximum string length: 255
​
take
number

Maximum number of rows to return. Capped at 30.

Required range: 1 <= x <= 30
Example:

30

​
includeDiff
boolean

When true, includes changed top-level fields and sanitized before/after values for returned rows only. COMPONENTS elements contain only genuinely changed elements.

Example:

false

​
includeData
enum<boolean>

Reserved for future payload expansion. v1 only accepts false; use GET /api/v1/activity/:refId/:version for full payloads.

Available options:
false
Example:

false

Response

OK.

Last modified on September 5, 2026