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

# List Activity

> Who changed which agent, when and what, across your whole account, newest first: every create, update, delete, restore, publish, tool, phone number and knowledge base change, with the person (dashboard user) or API key that made it and the fields that changed. The same records back each agent's version history (`GET /agents/{id}/revisions`), where the full before and after of a change can be read and a version restored.



## OpenAPI

````yaml GET /activity
openapi: 3.1.0
info:
  title: RevRing Voice AI API
  description: >-
    RevRing Voice AI platform API for managing AI voice agents, phone calls, SIP
    trunks, and analytics. Build intelligent voice applications that can handle
    inbound and outbound phone calls with AI-powered conversational agents.
  version: 1.0.0
  contact:
    name: RevRing Support
    url: https://revring.ai
servers:
  - url: https://api.revring.ai/v1
    description: Production API
security:
  - apiKeyAuth: []
tags:
  - name: Messaging Connections
    description: Connect messaging providers so agents can send text messages
  - name: Messages
    description: Send text messages and read your message log
  - name: Conversations
    description: List and clear managed conversation threads
  - name: SIP Trunks
    description: Manage SIP trunks for connecting agents to the phone network
  - name: Agents
    description: Manage AI voice agents and their configuration
  - name: Agent Folders
    description: Organize agents into folders for dashboard navigation
  - name: Calls
    description: Manage and query phone calls
  - name: Analytics
    description: Get analytics and metrics about your calls
  - name: Knowledge Bases
    description: >-
      Manage knowledge bases and sources for agent retrieval-augmented
      generation
  - name: Test Suites
    description: Manage test suites, test cases, and test runs for agent evaluation
  - name: Voices
    description: Browse the voices available to your organization for agent speech
  - name: Webhooks
    description: Webhook delivery settings for your organization
  - name: Alerts
    description: Alert rules on call metrics, delivered to a webhook or Slack
  - name: Contacts
    description: What your agents remember about people
  - name: Integrations
    description: Calendars your agents book on
  - name: Activity
    description: Who changed what, across the account.
paths:
  /activity:
    get:
      tags:
        - Activity
      summary: List Activity
      description: >-
        Who changed which agent, when and what, across your whole account,
        newest first: every create, update, delete, restore, publish, tool,
        phone number and knowledge base change, with the person (dashboard user)
        or API key that made it and the fields that changed. The same records
        back each agent's version history (`GET /agents/{id}/revisions`), where
        the full before and after of a change can be read and a version
        restored.
      operationId: listActivity
      parameters:
        - name: days
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 90
            default: 7
        - name: agentId
          in: query
          required: false
          schema:
            type: string
          description: Only this agent's changes.
        - name: actor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Only changes by this person or API key (substring of the email or
            key name, case-insensitive).
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: pageSize
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
      responses:
        '200':
          description: Changes, newest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        at:
                          type: string
                          format: date-time
                        actorType:
                          type: string
                          enum:
                            - user
                            - apiKey
                            - system
                        actorLabel:
                          type: string
                          nullable: true
                          description: The user's email or the API key's name.
                        agentId:
                          type: string
                        agentName:
                          type: string
                          description: >-
                            The agent's name at the time of the change (kept for
                            deleted agents).
                        reason:
                          type: string
                          description: >-
                            created, updated, deleted, restored, published,
                            duplicated, custom_tool_created,
                            custom_tool_updated, custom_tool_deleted,
                            phone_number_added, phone_number_removed,
                            knowledge_base_linked, knowledge_base_unlinked
                        changedFields:
                          type: array
                          items:
                            type: string
                          description: >-
                            Top-level agent fields whose value changed (`*` for
                            the first version).
                        revision:
                          type: integer
                          description: The agent's version number this change produced.
                  page:
                    type: integer
                  pageSize:
                    type: integer
                  total:
                    type: integer
                  hasNextPage:
                    type: boolean
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Generate API keys from the RevRing
        dashboard. A key is either full access or read-only; a read-only key is
        refused with 403 read_only_key on any request that creates, changes or
        deletes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.