Update service

POST /v2/Services/{Sid}

TODO: Resource-level docs

Path parameters

Sid string Required

Body

ConsumptionReportInterval integer
DefaultChannelCreatorRoleSid string

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
DefaultChannelRoleSid string

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
DefaultServiceRoleSid string

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
FriendlyName string
Limits.ChannelMembers integer
Limits.UserChannels integer
Media.CompatibilityMessage string
Notifications.AddedToChannel.Enabled boolean
Notifications.AddedToChannel.Sound string
Notifications.AddedToChannel.Template string
Notifications.InvitedToChannel.Enabled boolean
Notifications.InvitedToChannel.Sound string
Notifications.InvitedToChannel.Template string
Notifications.LogEnabled boolean
Notifications.NewMessage.BadgeCountEnabled boolean
Notifications.NewMessage.Enabled boolean
Notifications.NewMessage.Sound string
Notifications.NewMessage.Template string
Notifications.RemovedFromChannel.Enabled boolean
Notifications.RemovedFromChannel.Sound string
Notifications.RemovedFromChannel.Template string
PostWebhookRetryCount integer
PostWebhookUrl string(uri)
PreWebhookRetryCount integer
PreWebhookUrl string(uri)
ReachabilityEnabled boolean
ReadStatusEnabled boolean
TypingIndicatorTimeout integer
WebhookFilters array[string]
WebhookMethod string(http-method)

Values are HEAD, GET, POST, PATCH, PUT, or DELETE.

Responses

200

OK
Hide response attributes Show response attributes object
- account_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- consumption_report_interval integer | null
- date_created string(date-time) | null
- date_updated string(date-time) | null
- default_channel_creator_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- default_channel_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- default_service_role_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- friendly_name string | null
- limits
- links object(uri-map) | null
- media
- notifications
- post_webhook_retry_count integer | null
- post_webhook_url string | null
- pre_webhook_retry_count integer | null
- pre_webhook_url string | null
- reachability_enabled boolean | null
- read_status_enabled boolean | null
- sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
- typing_indicator_timeout integer | null
- url string(uri) | null
- webhook_filters array[string] | null
- webhook_method string | null

POST /v2/Services/{Sid}

curl \
 -X POST https://ip-messaging.twilio.com/v2/Services/{Sid} \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'ConsumptionReportInterval=42&DefaultChannelCreatorRoleSid=string&DefaultChannelRoleSid=string&DefaultServiceRoleSid=string&FriendlyName=string&Limits.ChannelMembers=42&Limits.UserChannels=42&Media.CompatibilityMessage=string&Notifications.AddedToChannel.Enabled=true&Notifications.AddedToChannel.Sound=string&Notifications.AddedToChannel.Template=string&Notifications.InvitedToChannel.Enabled=true&Notifications.InvitedToChannel.Sound=string&Notifications.InvitedToChannel.Template=string&Notifications.LogEnabled=true&Notifications.NewMessage.BadgeCountEnabled=true&Notifications.NewMessage.Enabled=true&Notifications.NewMessage.Sound=string&Notifications.NewMessage.Template=string&Notifications.RemovedFromChannel.Enabled=true&Notifications.RemovedFromChannel.Sound=string&Notifications.RemovedFromChannel.Template=string&PostWebhookRetryCount=42&PostWebhookUrl=https%3A%2F%2Fexample.com&PreWebhookRetryCount=42&PreWebhookUrl=https%3A%2F%2Fexample.com&ReachabilityEnabled=true&ReadStatusEnabled=true&TypingIndicatorTimeout=42&WebhookFilters=string&WebhookMethod=HEAD'

Request example

{
  "ConsumptionReportInterval": 42,
  "DefaultChannelCreatorRoleSid": "string",
  "DefaultChannelRoleSid": "string",
  "DefaultServiceRoleSid": "string",
  "FriendlyName": "string",
  "Limits.ChannelMembers": 42,
  "Limits.UserChannels": 42,
  "Media.CompatibilityMessage": "string",
  "Notifications.AddedToChannel.Enabled": true,
  "Notifications.AddedToChannel.Sound": "string",
  "Notifications.AddedToChannel.Template": "string",
  "Notifications.InvitedToChannel.Enabled": true,
  "Notifications.InvitedToChannel.Sound": "string",
  "Notifications.InvitedToChannel.Template": "string",
  "Notifications.LogEnabled": true,
  "Notifications.NewMessage.BadgeCountEnabled": true,
  "Notifications.NewMessage.Enabled": true,
  "Notifications.NewMessage.Sound": "string",
  "Notifications.NewMessage.Template": "string",
  "Notifications.RemovedFromChannel.Enabled": true,
  "Notifications.RemovedFromChannel.Sound": "string",
  "Notifications.RemovedFromChannel.Template": "string",
  "PostWebhookRetryCount": 42,
  "PostWebhookUrl": "https://example.com",
  "PreWebhookRetryCount": 42,
  "PreWebhookUrl": "https://example.com",
  "ReachabilityEnabled": true,
  "ReadStatusEnabled": true,
  "TypingIndicatorTimeout": 42,
  "WebhookFilters": [
    "string"
  ],
  "WebhookMethod": "HEAD"
}

Request examples

{
  "ConsumptionReportInterval": 42,
  "DefaultChannelCreatorRoleSid": "string",
  "DefaultChannelRoleSid": "string",
  "DefaultServiceRoleSid": "string",
  "FriendlyName": "string",
  "Limits.ChannelMembers": 42,
  "Limits.UserChannels": 42,
  "Media.CompatibilityMessage": "string",
  "Notifications.AddedToChannel.Enabled": true,
  "Notifications.AddedToChannel.Sound": "string",
  "Notifications.AddedToChannel.Template": "string",
  "Notifications.InvitedToChannel.Enabled": true,
  "Notifications.InvitedToChannel.Sound": "string",
  "Notifications.InvitedToChannel.Template": "string",
  "Notifications.LogEnabled": true,
  "Notifications.NewMessage.BadgeCountEnabled": true,
  "Notifications.NewMessage.Enabled": true,
  "Notifications.NewMessage.Sound": "string",
  "Notifications.NewMessage.Template": "string",
  "Notifications.RemovedFromChannel.Enabled": true,
  "Notifications.RemovedFromChannel.Sound": "string",
  "Notifications.RemovedFromChannel.Template": "string",
  "PostWebhookRetryCount": 42,
  "PostWebhookUrl": "https://example.com",
  "PreWebhookRetryCount": 42,
  "PreWebhookUrl": "https://example.com",
  "ReachabilityEnabled": true,
  "ReadStatusEnabled": true,
  "TypingIndicatorTimeout": 42,
  "WebhookFilters": [
    "string"
  ],
  "WebhookMethod": "HEAD"
}

Response examples (200)

{
  "account_sid": "string",
  "consumption_report_interval": 42,
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "default_channel_creator_role_sid": "string",
  "default_channel_role_sid": "string",
  "default_service_role_sid": "string",
  "friendly_name": "string",
  "links": {},
  "post_webhook_retry_count": 42,
  "post_webhook_url": "string",
  "pre_webhook_retry_count": 42,
  "pre_webhook_url": "string",
  "reachability_enabled": true,
  "read_status_enabled": true,
  "sid": "string",
  "typing_indicator_timeout": 42,
  "url": "https://example.com",
  "webhook_filters": [
    "string"
  ],
  "webhook_method": "string"
}

Response examples (200)

{
  "account_sid": "string",
  "consumption_report_interval": 42,
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "default_channel_creator_role_sid": "string",
  "default_channel_role_sid": "string",
  "default_service_role_sid": "string",
  "friendly_name": "string",
  "links": {},
  "post_webhook_retry_count": 42,
  "post_webhook_url": "string",
  "pre_webhook_retry_count": 42,
  "pre_webhook_url": "string",
  "reachability_enabled": true,
  "read_status_enabled": true,
  "sid": "string",
  "typing_indicator_timeout": 42,
  "url": "https://example.com",
  "webhook_filters": [
    "string"
  ],
  "webhook_method": "string"
}