> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revoengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List snapshot-backed resource activity

> List snapshot-backed resource activity. The request is scoped to activity visible to the authenticated caller.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/activity
openapi: 3.0.0
info:
  title: RevoEngine Platform API
  description: Official RevoEngine Platform API documentation.
  version: 1.3.0
  contact:
    name: Support
    email: support@revoengine.com
  termsOfService: https://docs.revoengine.com/tos
servers:
  - url: https://api.revoengine.com
    description: Production
security: []
tags:
  - name: Accounts
    description: Users, service accounts, API keys, status, and platform access.
    externalDocs:
      description: Identity and access guide
      url: https://docs.revoengine.com/operate/identity-and-access
  - name: Activity
    description: Snapshot-backed activity and version history.
    externalDocs:
      description: Observability guide
      url: https://docs.revoengine.com/operate/observability
  - name: Agent Memory
    description: Administrative access to durable Agent memory.
    externalDocs:
      description: Agent memory and workspaces guide
      url: https://docs.revoengine.com/ai/memory-and-workspaces
  - name: Agent Plugins
    description: Agent plugin definitions, synchronization, testing, and lifecycle.
    externalDocs:
      description: Agent plugins guide
      url: https://docs.revoengine.com/ai/plugins
  - name: Agents
    description: >-
      Agent definitions, runs, sessions, inboxes, memory, tools, workspaces, and
      lifecycle.
    externalDocs:
      description: Autonomous Agents guide
      url: https://docs.revoengine.com/ai/agents
  - name: Assistant
    description: >-
      Assistant threads, messages, responses, goals, reports, sharing,
      attachments, and control.
    externalDocs:
      description: Assistant guide
      url: https://docs.revoengine.com/ai/assistant
  - name: Automation
    description: >-
      Jobs, templates, schedules, events, webhooks, execution history, and
      lifecycle.
    externalDocs:
      description: Automation guide
      url: https://docs.revoengine.com/operate/automation
  - name: Chat
    description: Collaborative chat threads, messages, reactions, uploads, and attachments.
    externalDocs:
      description: Team Chat guide
      url: https://docs.revoengine.com/operate/chat
  - name: Component deployments
    description: >-
      Custom Node.js runtime deployment attempts, readiness, activation, and
      rollback.
    externalDocs:
      description: Custom Node.js guide
      url: https://docs.revoengine.com/build/custom-nodejs
  - name: Components
    description: Components, elements, versions, validation, activation, and lifecycle.
    externalDocs:
      description: Components guide
      url: https://docs.revoengine.com/build/components
  - name: Config
    description: Instance configuration, usage, logs, and cache administration.
    externalDocs:
      description: Instance settings guide
      url: https://docs.revoengine.com/platform/instance-settings
  - name: Database Cache
    description: Instance Database cache values and statistics.
    externalDocs:
      description: Database Cache guide
      url: https://docs.revoengine.com/operate/database-cache
  - name: Database Views
    description: Database Views, previews, refreshes, exports, and controlled data actions.
    externalDocs:
      description: Database Views guide
      url: https://docs.revoengine.com/operate/database-views
  - name: Databases
    description: Database definitions, data, audits, exports, cloning, and lifecycle.
    externalDocs:
      description: Databases guide
      url: https://docs.revoengine.com/operate/databases
  - name: Endpoints
    description: >-
      Endpoint definitions, activation, validation, generated OpenAPI, and
      statistics.
    externalDocs:
      description: Endpoints guide
      url: https://docs.revoengine.com/operate/endpoints
  - name: Files
    description: Compatibility file listing, preview, download, and deletion operations.
    externalDocs:
      description: Files compatibility guide
      url: https://docs.revoengine.com/operate/files
  - name: Groups
    description: Groups, membership, avatars, and lifecycle.
    externalDocs:
      description: Groups guide
      url: https://docs.revoengine.com/operate/groups
  - name: Me
    description: Current user profile, keys, avatar, and session information.
    externalDocs:
      description: Authentication guide
      url: https://docs.revoengine.com/developers/authentication
  - name: Preferences
    description: User and instance preference values.
    externalDocs:
      description: Platform UI guide
      url: https://docs.revoengine.com/platform/ui-tour
  - name: Role Groups
    description: Role groups, members, assigned roles, and lifecycle.
    externalDocs:
      description: Permissions guide
      url: https://docs.revoengine.com/operate/permissions
  - name: Roles
    description: Available platform roles and role details.
    externalDocs:
      description: Permissions guide
      url: https://docs.revoengine.com/operate/permissions
  - name: Search
    description: Cross-domain search over objects visible to the caller.
    externalDocs:
      description: Search and discovery guide
      url: https://docs.revoengine.com/platform/search
  - name: Secrets
    description: >-
      Secret definitions, revisions, activation, reveal, disable, and
      destruction.
    externalDocs:
      description: Secrets guide
      url: https://docs.revoengine.com/operate/secrets
  - name: Storage
    description: >-
      Storage workspaces, folders, objects, upload sessions, signed access, and
      lifecycle.
    externalDocs:
      description: Storage guide
      url: https://docs.revoengine.com/operate/storage
externalDocs:
  description: Documentation
  url: https://docs.revoengine.com
paths:
  /api/v1/activity:
    get:
      tags:
        - Activity
      summary: List snapshot-backed resource activity
      description: >-
        List snapshot-backed resource activity. The request is scoped to
        activity visible to the authenticated caller.
      operationId: ActivityController_getAll
      parameters:
        - name: refTypes
          required: false
          in: query
          description: >-
            Optional snapshot ref type filter. Accepts repeated values or a
            comma-separated list.
          schema:
            type: array
            items:
              type: string
              enum:
                - USERS
                - GROUPS
                - ROLE_GROUPS
                - COMPONENTS
                - ENDPOINTS
                - TEMPLATES
                - SCHEDULE
                - EVENTS
                - SECRETS
                - STORAGE
                - FILES
                - PREFERENCES
                - USER_KEYS
                - DATABASES
                - AGENTS
                - AGENT_PLUGINS
                - DATABASE_VIEWS
                - COMPONENT_ELEMENT
        - name: excludeRefTypes
          required: false
          in: query
          description: >-
            Optional snapshot ref types to exclude after refTypes inclusion is
            applied. Accepts repeated values or a comma-separated list.
          schema:
            type: array
            items:
              type: string
              enum:
                - USERS
                - GROUPS
                - ROLE_GROUPS
                - COMPONENTS
                - ENDPOINTS
                - TEMPLATES
                - SCHEDULE
                - EVENTS
                - SECRETS
                - STORAGE
                - FILES
                - PREFERENCES
                - USER_KEYS
                - DATABASES
                - AGENTS
                - AGENT_PLUGINS
                - DATABASE_VIEWS
                - COMPONENT_ELEMENT
        - name: term
          required: false
          in: query
          description: Optional term matched through the snapshot search vector.
          schema:
            maxLength: 100
            example: billing
            type: string
        - name: refId
          required: false
          in: query
          description: Optional exact resource id filter.
          schema:
            maxLength: 100
            example: 11111111-1111-4111-8111-111111111111
            type: string
        - name: createdBy
          required: false
          in: query
          description: Optional exact creator user id filter.
          schema:
            maxLength: 100
            example: 11111111-1111-4111-8111-111111111111
            type: string
        - name: from
          required: false
          in: query
          description: >-
            Inclusive lower ISO date bound. Overrides since. Exact refId history
            has no default lower bound.
          schema:
            example: '2026-06-29T00:00:00.000Z'
            type: string
        - name: to
          required: false
          in: query
          description: Inclusive upper ISO date bound.
          schema:
            example: '2026-06-30T00:00:00.000Z'
            type: string
        - name: since
          required: false
          in: query
          description: >-
            Relative lookback such as 24h, 7d, or 30m. Defaults to 24h only for
            broad browsing without refId.
          schema:
            maxLength: 16
            example: 24h
            type: string
        - name: cursor
          required: false
          in: query
          description: Pagination cursor returned by the previous response.
          schema:
            maxLength: 255
            type: string
        - name: take
          required: false
          in: query
          description: Maximum number of rows to return. Capped at 30.
          schema:
            minimum: 1
            maximum: 30
            example: 30
            type: number
        - name: includeDiff
          required: false
          in: query
          description: >-
            When true, includes changed top-level fields and sanitized
            before/after values for returned rows only. COMPONENTS elements
            contain only genuinely changed elements.
          schema:
            example: false
            type: boolean
        - name: includeData
          required: false
          in: query
          description: >-
            Reserved for future payload expansion. v1 only accepts false; use
            GET /api/v1/activity/:refId/:version for full payloads.
          schema:
            example: false
            type: boolean
            enum:
              - false
      responses:
        '200':
          description: OK.
        '403':
          description: Forbidden.
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      description: Bearer JWT token or API Key (sk-*).
      type: http

````