Objective
This article helps you read the JSON payload stored under a key in a Sync Map 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 Map, 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 Map.
- Select the Maps tab, then select the Map's SID to open it.
- Under Items, select View item data on the item's row. A panel opens showing the item's payload; select Copy item data 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 change when the parent Map expires.
- Select Save changes. The console confirms with "Map Item updated."
Additional Information
- Data must be valid JSON and can be up to 16 KiB.
- The item's Key cannot be changed. It is shown as a read-only value while editing to use a different key, create a new item and delete the old one.
- On an update, Collection time to live is only applied when the data or the item time to live 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.