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

# List document changes

> List the pages that sitemap syncs added or removed, and that refreshes found changed, in a date range.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/document/changes
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/document/changes:
    get:
      tags:
        - Document
      summary: List document changes
      description: List the pages that sitemap syncs added or removed, and that
        refreshes found changed, in a date range.
      operationId: StableDocumentController_listChanges
      parameters:
        - name: projectID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the project to operate on.
        - name: environmentAlias
          required: true
          in: query
          schema:
            type: string
            description: The alias of the environment to operate on (e.g. `main`).
        - name: from
          required: true
          in: query
          schema:
            type: string
            format: date-time
            pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            description: Only changes recorded at or after this ISO 8601 timestamp are
              returned.
        - name: to
          required: true
          in: query
          schema:
            type: string
            format: date-time
            pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            description: Only changes recorded before this ISO 8601 timestamp are returned.
        - name: sitemapDocumentID
          required: false
          in: query
          schema:
            description: When provided, only changes to the pages of the sitemap document
              with this ID are returned.
            type: string
            minLength: 1
        - name: type
          required: false
          in: query
          schema:
            description: When provided, only changes of this type are returned.
            allOf:
              - $ref: "#/components/schemas/KnowledgeBaseDocumentChangeType"
        - name: cursor
          required: false
          in: query
          schema:
            description: The nextCursor of the previous page. Leave it out for the first
              page.
            type: string
        - name: limit
          required: false
          in: query
          schema:
            description: The most changes to return. Defaults to 500.
            type: integer
            minimum: 1
            maximum: 500
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StableDocumentChangeListResponse"
      security:
        - token: []
components:
  schemas:
    KnowledgeBaseDocumentChangeType:
      type: string
      enum:
        - added
        - updated
        - removed
      x-enumNames:
        - ADDED
        - UPDATED
        - REMOVED
    StableDocumentChangeListResponse:
      type: object
      properties:
        changes:
          type: array
          items:
            $ref: "#/components/schemas/StableDocumentChange"
          description: Newest first.
        nextCursor:
          description: Present when more changes follow. Send it as cursor.
          type: string
      required:
        - changes
    StableDocumentChange:
      type: object
      properties:
        date:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: When the change was recorded.
        type:
          description: "`added` and `removed`: a sitemap sync added the page or dropped
            it. `updated`: a refresh found the page text changed."
          allOf:
            - $ref: "#/components/schemas/KnowledgeBaseDocumentChangeType"
          enum:
            - added
            - updated
            - removed
          x-enumNames:
            - ADDED
            - UPDATED
            - REMOVED
        documentID:
          nullable: true
          description: The changed document. A removed document no longer exists.
          type: string
        url:
          nullable: true
          description: The page URL at the time of the change.
          type: string
        sitemapDocumentID:
          nullable: true
          description: The sitemap document the page belongs to, or null for a URL
            document added on its own.
          type: string
      required:
        - date
        - type
        - documentID
        - url
        - sitemapDocumentID
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````
