WriteRelationships atomically writes and/or deletes a set of specified
relationships. An optional set of preconditions can be provided that must be satisfied for the operation to commit.
POST {{baseUrl}}/v1/relationships/write
Request Body
{"updates"=>[{"operation"=>"OPERATION_UNSPECIFIED", "relationship"=>{"resource"=>{"objectType"=>"<string>", "objectId"=>"<string>"}, "relation"=>"<string>", "subject"=>{"object"=>{"objectType"=>"<string>", "objectId"=>"<string>"}, "optionalRelation"=>"<string>"}, "optionalCaveat"=>{"caveatName"=>"<string>"}}}, {"operation"=>"OPERATION_UNSPECIFIED", "relationship"=>{"resource"=>{"objectType"=>"<string>", "objectId"=>"<string>"}, "relation"=>"<string>", "subject"=>{"object"=>{"objectType"=>"<string>", "objectId"=>"<string>"}, "optionalRelation"=>"<string>"}, "optionalCaveat"=>{"caveatName"=>"<string>"}}}], "optionalPreconditions"=>[{"operation"=>"OPERATION_UNSPECIFIED", "filter"=>{"resourceType"=>"<string>", "optionalResourceId"=>"<string>", "optionalRelation"=>"<string>", "optionalSubjectFilter"=>{"subjectType"=>"<string>", "optionalSubjectId"=>"<string>", "optionalRelation"=>{"relation"=>"<string>"}}}}, {"operation"=>"OPERATION_UNSPECIFIED", "filter"=>{"resourceType"=>"<string>", "optionalResourceId"=>"<string>", "optionalRelation"=>"<string>", "optionalSubjectFilter"=>{"subjectType"=>"<string>", "optionalSubjectId"=>"<string>", "optionalRelation"=>{"relation"=>"<string>"}}}}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"writtenAt":{"token":"\u003cstring\u003e"}}