Developers API reference Version 1 · generated from the code openapi.json
Routes

sharing

Change the sharing rules of a flow

PATCH /api/v1/flows/{entity_id}/sharing

reading_access: public opens the content to anyone who has its link, limited keeps it to its recipients. inherit: true makes it follow the sharing of the binder that holds it.

Required scope: share

Path parameters

  • entity_id integer · required

    Id of the binder or flow.

Request body application/json

  • inherit boolean or null · optional

    true to follow the sharing of the binder that holds it, false to give it rules of its own.

  • reading_access string or null · optional

    public opens it to anyone who has its link, limited keeps it to its recipients.

Response

200 Sharing

  • inherit boolean

    Whether it follows the sharing of the binder that holds it instead of rules of its own.

  • reading_access string

    Its own rule: public opens it to anyone who has its link, limited keeps it to its recipients.

  • effective_reading_access string

    The rule that really applies, inheritance included.

  • recipients array of Recipient

    Who it is shared with, pending invitations included.

    6 fields
    • id integer

      Id of the share, unique per type: what the recipient routes take as permission_id (or invitation_id).

    • type string

      user: an account. userslist: a sharing list. domain: every address of an email domain. invitation: an address that has no account yet.

    • name string

      The address, the name of the list, or the domain.

    • permission string

      What the recipient may do.

    • pending boolean

      true for an invitation not accepted yet.

    • sent boolean or null

      Invitations 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.

  • 409

    The current state of the content forbids the request.

  • 422

    A value is missing or malformed.

  • 429

    Too many requests; Retry-After gives the seconds to wait.

planner_banner_ad_pt