Objective
This article helps you give a client identity read, write, or manage access to a specific Sync List, and change that access later.
Product
Twilio Sync
Environment
Twilio Console
User Account Permission/Role(s) Required
Your user role must allow reading Twilio Sync Services to open the List, and updating them to save a permission.
Procedure
- In the Twilio Console, select Builder tools in the left sidebar.
- Select Sync, then Services.
- In the Name column, select the Service that holds the List.
- Select the Lists tab, then select the List's SID to open it.
- Select the Permissions tab.
- Select Add permission.
- In Identity, enter the identity of the token holder these permissions apply to.
- Select the access to give: Can read to read this Sync List and its items, Can write to create, update, and delete items in it, and Can manage to delete the List itself.
- Select Add. The identity appears in the table with Yes or No in the Can read, Can write, and Can manage columns.
To change an existing identity's access, open its row actions menu, select Edit, adjust the checkboxes, and select Save.
Additional Information
- Permissions are only enforced while access control is enabled on the parent Service. If it is off, the List's page shows the callout "Access control is off for this Sync Service" turn on ACL enabled on the Service's Configure tab for these permissions to take effect.
- The three access settings mean different things on a List than on a Document: read covers the List and its items, write covers creating, updating, and deleting items, and manage covers deleting the List.
- The identity is the address of the permission, so it is read-only when you edit an existing entry.
- An identity can be up to 256 characters.
- All three access settings are saved together every time, so clearing a checkbox removes that access. Enable at least one action saving with all three cleared has the same effect as revoking the identity.
This content was generated by AI and reviewed, edited, and verified by a human.