Controlling Access to Entries

By default, any entry you add will be accessible to any other member. You may add restrictions by specifying which members should have access to your entries using the API calls shown in this section.

To get a list of members and their member IDs, make a GET request to {app-url-v2}/members.

Listing Current Grants

To get a list of members to whom you have granted explicit access, make a GET request to {app-url-v2}/permissions/access. If no members are included in the response, then you have granted no explicit access and ALL members may see your entries.

get permissions diagram

Granting Access

To grant access to your entries to another member, make a POST request to {app-url-v2}/permissions/access/{memberId}, replacing {memberId} with the ID of the member for whom you are granting access. To remove access from all members except yourself, specify only your own member ID using this endpoint.

grant permission diagram

Revoking Access

To remove access to your entries from another member, make a DELETE request to {app-url-v2}/permissions/access/{memberId}, replacing {memberId} with the ID of the member for whom you are revoking access. If you remove the last permitted member, ALL members will be able to access your entries. Revoking access from a member for whom you have not previously granted explicit access has no effect.

retract access diagram