Interface ActivityInterface

Activity row — append-only audit entry.

Each row is a snapshot of a meaningful change to a user/org-scoped resource. The full pre/post-image of the source document lives on payload. Producers write one row per qualifying mutation; the unique event_id ensures idempotency across multiple relay processes tailing the same change stream.

interface ActivityInterface {
    active?: boolean;
    external_id?: string;
    extensors?: { [key: string]: string };
    record_history?: RecordHistory;
    id?: string;
    user?: string | { id?: string; [key: string]: any };
    org?: string | { id?: string; [key: string]: any };
    resource?: ActivityResource;
    resource_id?: string;
    operation?: ActivityOperation;
    payload?: null | Record<string, any>;
    event_id?: string;
}

Hierarchy (View Summary)

Properties

active?: boolean

Whether the entity is active

external_id?: string

External system identifier for integration with third-party systems

extensors?: { [key: string]: string }

Extended properties for custom integrations

record_history?: RecordHistory

Record history tracking information

id?: string

Unique identifier for the entity

user?: string | { id?: string; [key: string]: any }

Owner user reference (required if org is not set)

org?: string | { id?: string; [key: string]: any }

Owner org reference (required if user is not set)

resource?: ActivityResource

Normalized resource name (e.g. 'plan', 'task', 'drive_item')

resource_id?: string

ID of the source document that changed

operation?: ActivityOperation

CRUD verb

payload?: null | Record<string, any>

Snapshot of the source document at the time of the change

event_id?: string

Stringified change-stream resume token used as a dedupe key