listPolicyRevisions.md
List Policy Revisions
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
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
- name: Identity
description: Retrieve identity information for the authenticated user
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 <your-jwt-token>`
Use the Barndoor SDK's `loginInteractive()` function to obtain tokens
automatically.
HTTPBearer:
type: http
scheme: bearer