PingAuthorize API Reference

Branch Manager

The branch manager provides operations to create snapshots, as well as read, update, and merge policy branches.

Policy branches enable you to manage different sets of Trust Framework definitions and policies by storing these sets in separate branches. This is helpful in development environments, where you might need to quickly reconfigure PingAuthorize between policy branches.

To easily switch between policy branches and test configurations, define Policy External Servers for each branch and update the Policy Decision Service’s policy-server property. Learn more in Changing the active policy branch.

Learn about creating a new child branch in Snapshot Management.

Branch manager data model

Property Type Required Mutable Description

name

String

Required

Mutable

Specifies the name of the policy branch.

message

String

Required

Immutable

Provides the commit message for creation of a new snapshot.

fromBranchId

String

Required

Immutable

Specifies the branch to merge changes from.

resolutions

Resolution[]

Optional

Mutable

A collection that includes resolution objects for resolving merge conflicts.

Resolution data model

Property Type Required Mutable Description

resolutionType

String

Required

Immutable

Specifies the action to resolve the conflict.

entityReference

Entity reference[]

Required

Immutable

Provides a collection of entities causing the conflict.

Entity reference

Property Type Required Mutable Description

id

String

N/A

Read-only

Specifies the ID of the entity.

type

String

N/A

Read-only

Specifies the entity type.

Response codes

Code Message

201

Changes from the source branch were successfully merged into the destination branch.

204

Successful operation.

404

There is no branch in the system with the given ID.

409

The merge failed due to conflicting changes in the source and destination branches.