Activity

Read-only in every door.

activity.list · List activity

What happened in the brand: who did what and when, including actions taken by Nödo and external agents.

Input

{
  cursor?: string  // ≤ 512 · Opaque cursor from a previous `nextCursor`.
  limit?: integer  // 1–50 · default 20
}

Output

{
  items: Array<{
    id: string  // uuid
    actor: string
    action: string
    subject: string | null
    createdAt: string
  }>
  nextCursor: string | null
}

activity.history · Brand history

The brand history as the caller may read it: what everyone sees and, for whoever sees the settings (and staff with the brand's activity), access, money and connections too. Newest first; page with before.

Input

{
  before?: {
    at: string  // date-time
    id: string  // uuid
  }
  | null
  categories?: string[]  // ≤ 20 items
  search?: string  // ≤ 200
  from?: string | null
  to?: string | null
}

Output

{
  items: Array<{
    id: string
    ledger: string
    code: string
    category: string
    importance: string  // signal, milestone, follow_up or risk.
    occurredAt: string
    sentence: string  // «Ana creó el trabajo Logo nuevo», in the reader's locale and second person for their own acts.
    label: string  // Short label of the code («Trabajo creado»).
    actor: {
      id: string
      name: string | null
      avatarUrl: string | null
    }
    | null
    brand: {
      id: string
      name: string | null
      shortId: string | null
    }
    | null
    detail: string | null  // Staff feeds only: the free-text detail stored with the event.
  }>
  next: {
    at: string
    id: string
  }
  | null  // Pass as `before` for the next page; null on the last one.
  error: string | null
}

activity.personal · Your activity

What the caller did, or what happened to them, in the brands they reach and in their own account, in the history everyone in a brand may read (never the owners-only or staff lines). Newest first; page with before. A page can come back shorter than the rest while next still points further. brandId keeps it to one brand they reach.

Input

{
  before?: {
    at: string  // date-time
    id: string  // uuid
  }
  | null
  categories?: string[]  // ≤ 20 items
  brandId?: string | null
}

Output

{
  items: Array<{
    id: string
    ledger: string
    code: string
    category: string
    importance: string  // signal, milestone, follow_up or risk.
    occurredAt: string
    sentence: string  // «Ana creó el trabajo Logo nuevo», in the reader's locale and second person for their own acts.
    label: string  // Short label of the code («Trabajo creado»).
    actor: {
      id: string
      name: string | null
      avatarUrl: string | null
    }
    | null
    brand: {
      id: string
      name: string | null
      shortId: string | null
    }
    | null
    detail: string | null  // Staff feeds only: the free-text detail stored with the event.
  }>
  next: {
    at: string
    id: string
  }
  | null  // Pass as `before` for the next page; null on the last one.
  error: string | null
}