> ## Documentation Index > Fetch the complete documentation index at: https://docs.barndoor.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Policy Revisions > List all revisions for a given policy with pagination. Uses the same authorization as get_policy - if a user can read a policy, they can view its revision history. Args: changes_summary: Include human-readable change descriptions in response ## OpenAPI ````yaml GET /api/v2/policies/{policy_id}/revisions openapi: 3.1.0 info: title: Barndoor Platform API version: 1.0.0 description: > REST API for the Barndoor Platform - manage MCP servers, OAuth connections, and proxy MCP requests. ## Authentication All endpoints require a JWT Bearer token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE. The SDK handles the OAuth flow automatically using interactive login. ## MCP Integration The `/mcp/{mcp_server_name}` endpoints provide streaming proxy access to third-party MCP servers (Salesforce, Notion, Slack, etc.) with automatic authentication and session management. contact: name: Barndoor Support url: https://barndoor.ai servers: - url: https://{organization_id}.platform.barndoor.ai description: Trial (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndoor.ai description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndooruat.com description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org - url: https://{organization_id}.platform.barndoordev.com description: Enterprise (Production) variables: organization_id: description: Your organization identifier default: your-org security: - BearerAuth: [] tags: - name: Servers description: Manage MCP server instances - name: Connections description: Manage OAuth connections to MCP servers - name: Policies description: Manage access control policies for agents and servers - name: Agents description: Manage AI agent registrations - name: MCP Proxy description: Proxy requests to MCP servers paths: /api/v2/policies/{policy_id}/revisions: get: summary: List Policy Revisions description: |- List all revisions for a given policy with pagination. Uses the same authorization as get_policy - if a user can read a policy, they can view its revision history. Args: changes_summary: Include human-readable change descriptions in response operationId: list_policy_revisions_admin_v2_policies__policy_id__revisions_get parameters: - name: policy_id in: path required: true schema: type: string format: uuid title: Policy Id - name: changes_summary in: query required: false schema: type: boolean description: Include human-readable change descriptions in response default: false title: Changes Summary description: Include human-readable change descriptions in response - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-based) default: 1 title: Page description: Page number (1-based) - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Number of items per page (max 100) default: 10 title: Limit description: Number of items per page (max 100) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginationResponse_PolicyRevisionSummary_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: PaginationResponse_PolicyRevisionSummary_: properties: data: items: $ref: '#/components/schemas/PolicyRevisionSummary' type: array title: Data description: Array of items for current page pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - data - pagination title: PaginationResponse[PolicyRevisionSummary] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PolicyRevisionSummary: properties: id: type: string format: uuid title: Id policy_id: type: string format: uuid title: Policy Id changes: additionalProperties: true type: object title: Changes description: Changes made in this revision changes_summary: anyOf: - items: type: string type: array - type: 'null' title: Changes Summary description: Human-readable list of change descriptions revised_at: type: string format: date-time title: Revised At revised_by: type: string title: Revised By revised_by_name: anyOf: - type: string - type: 'null' title: Revised By Name description: Name of the user who made the revision type: object required: - id - policy_id - changes - revised_at - revised_by title: PolicyRevisionSummary description: Summary of a policy revision. PaginationMeta: properties: page: type: integer title: Page description: Current page number limit: type: integer title: Limit description: Items per page total: type: integer title: Total description: Total number of items pages: type: integer title: Pages description: Total number of pages previous_page: anyOf: - type: integer - type: 'null' title: Previous Page description: Previous page number (null if first page) next_page: anyOf: - type: integer - type: 'null' title: Next Page description: Next page number (null if last page) type: object required: - page - limit - total - pages - previous_page - next_page title: PaginationMeta description: Pagination metadata. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: > JWT token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE. The token should be included in the Authorization header: `Authorization: Bearer ` Use the Barndoor SDK's `loginInteractive()` function to obtain tokens automatically. HTTPBearer: type: http scheme: bearer ````