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

# List Revisions

> List audit-trail revisions for library and agent entities, with optional filters by entity type, entity oIds, date range, and author. Returns lightweight summaries — use `getRevision` to fetch a single revision's full before/after state or diff.



## OpenAPI

````yaml get /api/v2/revision/list
openapi: 3.0.0
info:
  version: 1.0.0
  title: Octave API
  description: API for Octave workspace management and AI-powered content generation
servers:
  - url: https://app.octavehq.com
security:
  - ApiKeyAuth: []
paths:
  /api/v2/revision/list:
    get:
      tags:
        - Revisions
      summary: List Revisions
      description: >-
        List audit-trail revisions for library and agent entities, with optional
        filters by entity type, entity oIds, date range, and author. Returns
        lightweight summaries — use `getRevision` to fetch a single revision's
        full before/after state or diff.
      operationId: listRevisions
      parameters:
        - schema:
            type: array
            items:
              type: string
              enum:
                - Product
                - Service
                - Solution
                - Persona
                - UseCase
                - Reference
                - Segment
                - Competitor
                - Alternative
                - BuyingTrigger
                - Objection
                - ProofPoint
                - Playbook
                - ContentAgent
                - Hypothesis
                - WorkspaceCompany
                - WritingStyle
                - BrandVoice
                - ChainedAgentWorkflow
                - SmartExample
            description: >-
              Optional list of entity types to filter revisions to (Persona,
              Product, Service, Solution, Segment, UseCase, Competitor,
              Alternative, BuyingTrigger, Objection, ProofPoint, Reference,
              Playbook, ContentAgent, Hypothesis, WorkspaceCompany,
              WritingStyle, BrandVoice, ChainedAgentWorkflow, SmartExample).
          required: false
          name: entityTypes
          in: query
        - schema:
            type: array
            items:
              type: string
            maxItems: 20
            description: >-
              Optional list of entity oIds (e.g. 'pe_*' for persona, 'pb_*' for
              playbook) to constrain the search to revisions of those specific
              entities. Capped at 20.
          required: false
          name: entityOIds
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              Optional ISO 8601 start date — return revisions created on or
              after this date.
          required: false
          name: startDate
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              Optional ISO 8601 end date — return revisions created on or before
              this date.
          required: false
          name: endDate
          in: query
        - schema:
            type: string
            description: >-
              Optional user oId (e.g. 'u_*') to filter revisions to changes
              authored by a specific user.
          required: false
          name: authorOId
          in: query
        - schema:
            type: boolean
            nullable: true
            default: false
            description: >-
              If true, include revisions that have already been restored.
              Defaults to false.
          required: false
          name: includeRestored
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
            description: Maximum number of revisions to return (default 25, max 100).
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            nullable: true
            minimum: 0
            default: 0
            description: Pagination offset (default 0).
          required: false
          name: offset
          in: query
      responses:
        '200':
          description: List of revisions for the workspace.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      revisions:
                        type: array
                        items:
                          type: object
                          properties:
                            revisionOId:
                              type: string
                              description: Revision oId (ev_* prefix).
                            summary:
                              type: string
                              nullable: true
                              description: >-
                                LLM-generated summary of the changes captured by
                                this revision.
                            entityName:
                              type: string
                              nullable: true
                              description: >-
                                Display name of the entity at the time of the
                                revision.
                            entityType:
                              type: string
                              enum:
                                - Product
                                - Service
                                - Solution
                                - Persona
                                - UseCase
                                - Reference
                                - Segment
                                - Competitor
                                - Alternative
                                - BuyingTrigger
                                - Objection
                                - ProofPoint
                                - Playbook
                                - ContentAgent
                                - Hypothesis
                                - WorkspaceCompany
                                - WritingStyle
                                - BrandVoice
                                - ChainedAgentWorkflow
                                - SmartExample
                              description: Type of the entity.
                            entityOId:
                              type: string
                              nullable: true
                              description: The entity's oId (from the stored entityData).
                            createdAt:
                              type: string
                              description: >-
                                ISO 8601 timestamp when the revision was
                                created.
                            authorName:
                              type: string
                              nullable: true
                              description: >-
                                Display name of the user who authored the
                                revision, when known.
                          required:
                            - revisionOId
                            - summary
                            - entityName
                            - entityType
                            - entityOId
                            - createdAt
                            - authorName
                      total:
                        type: integer
                        description: Total number of revisions matching the filters.
                      limit:
                        type: integer
                      offset:
                        type: integer
                    required:
                      - revisions
                      - total
                      - limit
                      - offset
                required:
                  - data
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````