---
updatedAt: 2026-07-10T17:11:53.000Z
---

# Get the updates between two RBP Policy versions

Get the updates between two RBP Policy versions, detailing version metadata and differences

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "This API provides access to control BeyondTrust software for Endpoint Privilege Management Linux.",
    "title": "Endpoint Privilege Management Linux API",
    "version": "25.1.6"
  },
  "security": [
    {
      "nomine-authorizer": []
    }
  ],
  "paths": {
    "/api/pbul/{hostid}/rbp/diff": {
      "get": {
        "description": "Get the updates between two RBP Policy versions, detailing version metadata and differences",
        "tags": [
          "RBP",
          "saas"
        ],
        "summary": "Get the updates between two RBP Policy versions",
        "operationId": "rbpGetDiff",
        "parameters": [
          {
            "x-go-name": "HostID",
            "description": "The Host ID to perform this operation on",
            "name": "hostid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "x-go-name": "Left",
            "description": "The Left Version is the (usually the older) version to diff from, starting at 1.",
            "name": "left",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "uint64"
            }
          },
          {
            "x-go-name": "Right",
            "description": "The Right Version is the (usually the newer) version to diff to, where zero (or unspecified) means current version.",
            "name": "right",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "uint64"
            }
          },
          {
            "x-go-name": "TransactionData",
            "description": "Whether to include transaction data when diffing against current version",
            "name": "transaction_data",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/rbpDiffResponse"
          },
          "400": {
            "$ref": "#/components/responses/TextError"
          }
        },
        "x-amazon-apigateway-integration": {
          "type": "aws_proxy",
          "httpMethod": "POST",
          "uri": "${biulInvocationArn}"
        }
      }
    }
  },
  "components": {
    "responses": {
      "TextError": {
        "description": "TextError An unknown error occurred, details provided in body"
      },
      "rbpDiffResponse": {
        "description": "RBPDiffResponse is a JSON object containing a summary of the differences between RBP policy versions",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RBPDiffSummary"
            }
          }
        }
      }
    },
    "schemas": {
      "ComplexGroupOutput": {
        "description": "For roles as they have multiple named sub-lists",
        "type": "object",
        "properties": {
          "action": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Action"
          },
          "comment": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Comment"
          },
          "description": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Description"
          },
          "disabled": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "integer",
                "format": "int64",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Disabled"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "x-go-name": "ID"
          },
          "iolog": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "IOLog"
          },
          "items": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/ItemWithStatus"
              },
              "maxItems": 500
            },
            "x-go-name": "Items"
          },
          "message": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Message"
          },
          "name": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Name"
          },
          "order": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "integer",
                "format": "int64",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Order"
          },
          "risk": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "integer",
                "format": "int64",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Risk"
          },
          "rpt": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "integer",
                "format": "int64",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Rpt"
          },
          "script": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Script"
          },
          "tag": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Tag"
          },
          "variables": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Variables"
          },
          "varmatch": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "x-go-name": "Value"
              }
            },
            "x-go-name": "VarMatch"
          }
        },
        "x-go-package": "pbsmc/remote/pbrest/entities"
      },
      "FieldStatus": {
        "description": "For tracking when top-level fields change",
        "type": "string",
        "x-go-package": "pbsmc/remote/pbrest/entities"
      },
      "GroupOutput": {
        "description": "A single, unified output struct for simple groups (hosts, users, cmds, tmdates)",
        "type": "object",
        "properties": {
          "description": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Description"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "x-go-name": "ID"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ItemWithStatus"
            },
            "x-go-name": "Items",
            "maxItems": 500
          },
          "name": {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/FieldStatus"
              },
              "value": {
                "type": "string",
                "x-go-name": "Value"
              }
            },
            "x-go-name": "Name"
          }
        },
        "x-go-package": "pbsmc/remote/pbrest/entities"
      },
      "ItemStatus": {
        "description": "For tracking when items were added/removed/unchanged within a group",
        "type": "string",
        "x-go-package": "pbsmc/remote/pbrest/entities"
      },
      "ItemWithStatus": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/ItemStatus"
          },
          "value": {
            "type": "string",
            "x-go-name": "Value"
          }
        },
        "x-go-package": "pbsmc/remote/pbrest/entities"
      },
      "RBPDiffSummary": {
        "description": "RBPDiffSummary describes the summary and differences of two RBP policies",
        "type": "object",
        "properties": {
          "left_details": {
            "$ref": "#/components/schemas/RBPVersion"
          },
          "right_details": {
            "$ref": "#/components/schemas/RBPVersion"
          },
          "summary": {
            "$ref": "#/components/schemas/Summary"
          }
        },
        "x-go-package": "pbsmc/data/dtos"
      },
      "RBPVersion": {
        "description": "RBPVersion is a record of a particular version of an RBP Policy",
        "type": "object",
        "required": [
          "created",
          "version",
          "who",
          "why"
        ],
        "properties": {
          "created": {
            "description": "Creation time of the version (RFC3339)",
            "type": "string",
            "x-go-name": "Created",
            "example": "2018-10-02T14:34:29Z"
          },
          "version": {
            "description": "Version number of the version",
            "type": "integer",
            "format": "uint64",
            "x-go-name": "Version",
            "example": 4
          },
          "who": {
            "description": "Username of the creator of the version",
            "type": "string",
            "x-go-name": "Who",
            "example": "blanka"
          },
          "why": {
            "description": "Reason message associated with the creation of version",
            "type": "string",
            "x-go-name": "Why",
            "example": "Added policy relating to electricity attacks."
          }
        },
        "x-go-package": "pbsmc/data/dtos"
      },
      "Summary": {
        "type": "object",
        "properties": {
          "createdCmdGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "CreatedCmdGrps",
            "maxItems": 500
          },
          "createdHostGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "CreatedHostGrps",
            "maxItems": 500
          },
          "createdRoles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplexGroupOutput"
            },
            "x-go-name": "CreatedRoles",
            "maxItems": 500
          },
          "createdTMDateGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "CreatedTMDateGrps",
            "maxItems": 500
          },
          "createdUserGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "CreatedUserGrps",
            "maxItems": 500
          },
          "deletedCmdGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "DeletedCmdGrps",
            "maxItems": 500
          },
          "deletedHostGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "DeletedHostGrps",
            "maxItems": 500
          },
          "deletedRoles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplexGroupOutput"
            },
            "x-go-name": "DeletedRoles",
            "maxItems": 500
          },
          "deletedTMDateGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "DeletedTMDateGrps",
            "maxItems": 500
          },
          "deletedUserGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "DeletedUserGrps",
            "maxItems": 500
          },
          "updatedCmdGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "UpdatedCmdGrps",
            "maxItems": 500
          },
          "updatedHostGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "UpdatedHostGrps",
            "maxItems": 500
          },
          "updatedRoles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplexGroupOutput"
            },
            "x-go-name": "UpdatedRoles",
            "maxItems": 500
          },
          "updatedTMDateGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "UpdatedTMDateGrps",
            "maxItems": 500
          },
          "updatedUserGrps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupOutput"
            },
            "x-go-name": "UpdatedUserGrps",
            "maxItems": 500
          }
        },
        "x-go-package": "pbsmc/remote/pbrest/entities"
      }
    },
    "securitySchemes": {
      "nomine-authorizer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-amazon-apigateway-authtype": "custom",
        "x-amazon-apigateway-authorizer": {
          "type": "request",
          "authorizerUri": "${authorizerInvokeArn}",
          "authorizerResultTtlInSeconds": 300,
          "identitySource": "method.request.header.Authorization"
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.beyondtrust.io/site/{siteid}/epm/linux"
    }
  ],
  "x-readme": {}
}
```