ReadRelationships reads a set of the relationships matching one or more

filters.

POST {{baseUrl}}/v1/relationships/read

Request Body

{"consistency"=>{"minimizeLatency"=>"<boolean>", "atLeastAsFresh"=>{"token"=>"<string>"}, "atExactSnapshot"=>{"token"=>"<string>"}, "fullyConsistent"=>"<boolean>"}, "relationshipFilter"=>{"resourceType"=>"<string>", "optionalResourceId"=>"<string>", "optionalRelation"=>"<string>", "optionalSubjectFilter"=>{"subjectType"=>"<string>", "optionalSubjectId"=>"<string>", "optionalRelation"=>{"relation"=>"<string>"}}}, "optionalLimit"=>"<long>", "optionalCursor"=>{"token"=>"<string>"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;result&quot;:{&quot;readAt&quot;:{&quot;token&quot;:&quot;\u003cstring\u003e&quot;},&quot;relationship&quot;:{&quot;resource&quot;:{&quot;objectType&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectId&quot;:&quot;\u003cstring\u003e&quot;},&quot;relation&quot;:&quot;\u003cstring\u003e&quot;,&quot;subject&quot;:{&quot;object&quot;:{&quot;objectType&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectId&quot;:&quot;\u003cstring\u003e&quot;},&quot;optionalRelation&quot;:&quot;\u003cstring\u003e&quot;},&quot;optionalCaveat&quot;:{&quot;caveatName&quot;:&quot;\u003cstring\u003e&quot;,&quot;context&quot;:{}}},&quot;afterResultCursor&quot;:{&quot;token&quot;:&quot;\u003cstring\u003e&quot;}},&quot;error&quot;:{&quot;code&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;details&quot;:[{&quot;@type&quot;:&quot;\u003cstring\u003e&quot;,&quot;labore_9a&quot;:{}},{&quot;@type&quot;:&quot;\u003cstring\u003e&quot;}]}}