sharing
Read the sharing of a flow
/api/v1/flows/{entity_id}/sharing
The sharing rules and the recipients: accounts, sharing lists, email domains and pending invitations.
key
Required scope: share
Path parameters
-
entity_idinteger · requiredId of the binder or flow.
Response
200
Sharing
-
inheritbooleanWhether it follows the sharing of the binder that holds it instead of rules of its own.
-
reading_accessstringIts own rule:
publicopens it to anyone who has its link,limitedkeeps it to its recipients. -
effective_reading_accessstringThe rule that really applies, inheritance included.
-
recipientsarray of RecipientWho it is shared with, pending invitations included.
6 fields
-
idintegerId of the share, unique per
type: what the recipient routes take aspermission_id(orinvitation_id). -
typestringuser: an account.userslist: a sharing list.domain: every address of an email domain.invitation: an address that has no account yet. -
namestringThe address, the name of the list, or the domain.
-
permissionstringWhat the recipient may do.
-
pendingbooleantruefor an invitation not accepted yet. -
sentboolean or nullInvitations only: whether the invitation email left.
-
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
404
Nothing with that id, or nothing the account may open.
-
429
Too many requests;
Retry-Aftergives the seconds to wait.