Path parameters
-
The SID of the Sync Service to create the new List Item in.
-
The SID of the Sync List to add the new List Item to. Can be the Sync List resource's
sid
or itsunique_name
.
Body
-
CollectionTtl integer
How long, in seconds, before the List Item's parent Sync List expires (time-to-live) and is deleted.
-
Data Required
A JSON string that represents an arbitrary, schema-less object that the List Item stores. Can be up to 16 KiB in length.
-
ItemTtl integer
How long, in seconds, before the List Item expires (time-to-live) and is deleted.
-
Ttl integer
An alias for
item_ttl
. If both parameters are provided, this value is ignored.
POST /v1/Services/{ServiceSid}/Lists/{ListSid}/Items
curl \
-X POST https://sync.twilio.com/v1/Services/{ServiceSid}/Lists/{ListSid}/Items \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'CollectionTtl=42&ItemTtl=42&Ttl=42'
Request example
{
"CollectionTtl": 42,
"ItemTtl": 42,
"Ttl": 42
}
Request examples
{
"CollectionTtl": 42,
"ItemTtl": 42,
"Ttl": 42
}
Response examples (201)
{
"account_sid": "string",
"created_by": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_expires": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"index": 42,
"list_sid": "string",
"revision": "string",
"service_sid": "string",
"url": "https://example.com"
}
Response examples (201)
{
"account_sid": "string",
"created_by": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_expires": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"index": 42,
"list_sid": "string",
"revision": "string",
"service_sid": "string",
"url": "https://example.com"
}