Objective
This article helps you read the JSON payload stored in a Sync List item and change it. Every subscribed client receives the updated payload in real time.
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 change to an item.
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.
- On the Items tab, select the arrow at the start of the item's row (View item data) to open a panel showing the item's payload. Select Copy to copy it, and press Escape to close the panel.
- To change the payload, open the item's row actions menu and select Edit.
- Edit the JSON in Data.
- Optionally set Item time to live to change when this item expires, and Collection time to live to extend the parent List's expiry.
- Select Save. The console confirms which item index was updated.
Additional Information
- Data must be valid JSON and can be up to 16 KiB.
- An item's Index is generated by Twilio and cannot be edited. It is shown in the panel title while editing.
- On an update, Collection time to live is only applied when the data or the item time to live also changes in the same save.
- The save is conditional on the revision the page read for that item. If the item changed in the meantime, your save is rejected instead of overwriting the other change reload the page and reapply your edit.
This content was generated by AI and reviewed, edited, and verified by a human.