Skip to content

informationBarrierRelationships

Information Barrier Relationships. Check whether two users or segments are allowed to communicate. The informationBarrierRelationships entity set lives under /exchange/v1.0/informationBarrierRelationships in the Governance & protection category.

Fact Value
Path /exchange/v1.0/informationBarrierRelationships
Category Governance & protection
Tier Tier 5, Compliance
Read role Compliance.IPPS.Read.All (Community)
Write role none (read-only)
Backing cmdlets Get-ExoInformationBarrierRelationship
Method Path Synopsis Role Plan
GET /exchange/v1.0/informationBarrierRelationships Query the IB relationship between two recipients (both query params REQUIRED). Compliance.IPPS.Read Community

GET /exchange/v1.0/informationBarrierRelationships

Section titled “GET /exchange/v1.0/informationBarrierRelationships”

Query the IB relationship between two recipients (both query params REQUIRED).

Backing cmdlet: Get-ExoInformationBarrierRelationship. Role: Compliance.IPPS.Read (Community).

Parameter In Type Required Description
recipientId1 query string Sender recipient - SMTP, alias, GUID, or other identifier. REQUIRED.
recipientId2 query string Counterparty recipient - same accepted forms as recipientId1. REQUIRED.

Query informationBarrierRelationships without both recipient params - 400

Section titled “Query informationBarrierRelationships without both recipient params - 400”

Get the informationBarrierRelationships endpoint without supplying ?recipientId1= AND ?recipientId2=. Get-ExoInformationBarrierRelationship CHECKS the IB relationship between TWO specific recipients - it is inherently a query, not a list. The controller pre-validates both query params and returns 400 with a canonical MissingRequiredQuery envelope before invoking the cmdlet. Fix: provide both recipients.

GET /exchange/v1.0/informationBarrierRelationships HTTP/1.1
Authorization: Bearer {token}
HTTP/1.1 400 Bad Request
{
"error": {
"code": "MissingRequiredQuery",
"message": "Both 'recipientId1' and 'recipientId2' query parameters are required. Get-ExoInformationBarrierRelationship checks the IB relationship between TWO specific recipients - list-all is not supported by the cmdlet."
}
}

Related: GET /exchange/v1.0/informationBarrierPolicies, GET /exchange/v1.0/informationBarrierSegments