Path parameters
-
The SID of the Sync Service to create the Map Item in.
-
The SID of the Sync Map to add the new Map Item to. Can be the Sync Map resource's
sid
or itsunique_name
.
Body
-
CollectionTtl integer
How long, in seconds, before the Map Item's parent Sync Map expires (time-to-live) and is deleted.
-
Data Required
A JSON string that represents an arbitrary, schema-less object that the Map Item stores. Can be up to 16 KiB in length.
-
ItemTtl integer
How long, in seconds, before the Map Item expires (time-to-live) and is deleted.
-
The unique, user-defined key for the Map Item. Can be up to 320 characters long.
-
Ttl integer
An alias for
item_ttl
. If both parameters are provided, this value is ignored.
POST /v1/Services/{ServiceSid}/Maps/{MapSid}/Items
curl \
-X POST https://sync.twilio.com/v1/Services/{ServiceSid}/Maps/{MapSid}/Items \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'CollectionTtl=42&ItemTtl=42&Key=string&Ttl=42'
Request example
{
"CollectionTtl": 42,
"ItemTtl": 42,
"Key": "string",
"Ttl": 42
}
Request examples
{
"CollectionTtl": 42,
"ItemTtl": 42,
"Key": "string",
"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",
"key": "string",
"map_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",
"key": "string",
"map_sid": "string",
"revision": "string",
"service_sid": "string",
"url": "https://example.com"
}