Update service

POST /v1/Services/{Sid}

Account sid auth token

Path parameters

Sid string Required

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

application/x-www-form-urlencoded

Body

FriendlyName string
DefaultServiceRoleSid 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}$.
DefaultChannelCreatorRoleSid string

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
ReadStatusEnabled boolean
ReachabilityEnabled boolean
TypingIndicatorTimeout integer
ConsumptionReportInterval integer
Notifications.NewMessage.Enabled boolean
Notifications.NewMessage.Template string
Notifications.AddedToChannel.Enabled boolean
Notifications.AddedToChannel.Template string
Notifications.RemovedFromChannel.Enabled boolean
Notifications.RemovedFromChannel.Template string
Notifications.InvitedToChannel.Enabled boolean
Notifications.InvitedToChannel.Template string
PreWebhookUrl string(uri)
PostWebhookUrl string(uri)
WebhookMethod string(http-method)

Values are GET or POST.
WebhookFilters array[string]
Webhooks.OnMessageSend.Url string(uri)
Webhooks.OnMessageSend.Method string(http-method)

Values are GET or POST.
Webhooks.OnMessageUpdate.Url string(uri)
Webhooks.OnMessageUpdate.Method string(http-method)

Values are GET or POST.
Webhooks.OnMessageRemove.Url string(uri)
Webhooks.OnMessageRemove.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelAdd.Url string(uri)
Webhooks.OnChannelAdd.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelDestroy.Url string(uri)
Webhooks.OnChannelDestroy.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelUpdate.Url string(uri)
Webhooks.OnChannelUpdate.Method string(http-method)

Values are GET or POST.
Webhooks.OnMemberAdd.Url string(uri)
Webhooks.OnMemberAdd.Method string(http-method)

Values are GET or POST.
Webhooks.OnMemberRemove.Url string(uri)
Webhooks.OnMemberRemove.Method string(http-method)

Values are GET or POST.
Webhooks.OnMessageSent.Url string(uri)
Webhooks.OnMessageSent.Method string(http-method)

Values are GET or POST.
Webhooks.OnMessageUpdated.Url string(uri)
Webhooks.OnMessageUpdated.Method string(http-method)

Values are GET or POST.
Webhooks.OnMessageRemoved.Url string(uri)
Webhooks.OnMessageRemoved.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelAdded.Url string(uri)
Webhooks.OnChannelAdded.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelDestroyed.Url string(uri)
Webhooks.OnChannelDestroyed.Method string(http-method)

Values are GET or POST.
Webhooks.OnChannelUpdated.Url string(uri)
Webhooks.OnChannelUpdated.Method string(http-method)

Values are GET or POST.
Webhooks.OnMemberAdded.Url string(uri)
Webhooks.OnMemberAdded.Method string(http-method)

Values are GET or POST.
Webhooks.OnMemberRemoved.Url string(uri)
Webhooks.OnMemberRemoved.Method string(http-method)

Values are GET or POST.
Limits.ChannelMembers integer
Limits.UserChannels integer

Responses

200 application/json

OK
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
  
  Specify the origin(s) allowed to access the resource
- Access-Control-Allow-Methods string
  
  Specify the HTTP methods allowed when accessing the resource
- Access-Control-Allow-Headers string
  
  Specify the headers allowed when accessing the resource
- Access-Control-Allow-Credentials boolean
  
  Indicates whether the browser should include credentials
- Access-Control-Expose-Headers string
  
  Headers exposed to the client
Hide response attributes Show response attributes object
- sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
- account_sid string | null
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- friendly_name string | null
- date_created string(date-time) | null
- date_updated string(date-time) | null
- 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}$.
- 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_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}$.
- read_status_enabled boolean | null
- reachability_enabled boolean | null
- typing_indicator_timeout integer
  
  Default value is 0.
- consumption_report_interval integer
  
  Default value is 0.
- limits
- webhooks
- pre_webhook_url string | null
- post_webhook_url string | null
- webhook_method string | null
- webhook_filters array[string] | null
- notifications
- url string(uri) | null
- links object(uri-map) | null

POST /v1/Services/{Sid}

curl \
 --request POST 'https://ip-messaging.twilio.com/v1/Services/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'FriendlyName=friendly_name&PreWebhookUrl=pre_webhook_url&WebhookMethod=webhook_method&PostWebhookUrl=post_webhook_url&WebhookFilters=webhook_filters&ReadStatusEnabled=false&Limits.UserChannels=500&ReachabilityEnabled=false&DefaultChannelRoleSid=RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&DefaultServiceRoleSid=RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&Limits.ChannelMembers=600&TypingIndicatorTimeout=100&Webhooks.OnMemberAdd.Url=webhooks.on_member_add.url&ConsumptionReportInterval=100&Webhooks.OnChannelAdd.Url=webhooks.on_channel_add.url&Webhooks.OnMemberAdded.Url=webhooks.on_member_added.url&Webhooks.OnMessageSend.Url=webhooks.on_message_send.url&Webhooks.OnMessageSent.Url=webhooks.on_message_sent.url&Webhooks.OnChannelAdded.Url=webhooks.on_channel_added.url&Webhooks.OnMemberAdd.Format=webhooks.on_member_add.format&Webhooks.OnMemberAdd.Method=webhooks.on_member_add.method&Webhooks.OnMemberRemove.Url=webhooks.on_member_remove.url&DefaultChannelCreatorRoleSid=RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&Webhooks.OnChannelAdd.Format=webhooks.on_channel_add.format&Webhooks.OnChannelAdd.Method=webhooks.on_channel_add.method&Webhooks.OnChannelUpdate.Url=webhooks.on_channel_update.url&Webhooks.OnMemberRemoved.Url=webhooks.on_member_removed.url&Webhooks.OnMessageRemove.Url=webhooks.on_message_remove.url&Webhooks.OnMessageUpdate.Url=webhooks.on_message_update.url&Webhooks.OnChannelDestroy.Url=webhooks.on_channel_destroy.url&Webhooks.OnChannelUpdated.Url=webhooks.on_channel_updated.url&Webhooks.OnMemberAdded.Format=webhooks.on_member_added.format&Webhooks.OnMemberAdded.Method=webhooks.on_member_added.method&Webhooks.OnMessageRemoved.Url=webhooks.on_message_removed.url&Webhooks.OnMessageSend.Format=webhooks.on_message_send.format&Webhooks.OnMessageSend.Method=webhooks.on_message_send.method&Webhooks.OnMessageSent.Format=webhooks.on_message_sent.format&Webhooks.OnMessageSent.Method=webhooks.on_message_sent.method&Webhooks.OnMessageUpdated.Url=webhooks.on_message_updated.url&Webhooks.OnChannelAdded.Format=webhooks.on_channel_added.format&Webhooks.OnChannelAdded.Method=webhooks.on_channel_added.method&Webhooks.OnMemberRemove.Format=webhooks.on_member_remove.format&Webhooks.OnMemberRemove.Method=webhooks.on_member_remove.method&Webhooks.OnChannelDestroyed.Url=webhooks.on_channel_destroyed.url&Webhooks.OnChannelUpdate.Format=webhooks.on_channel_update.format&Webhooks.OnChannelUpdate.Method=webhooks.on_channel_update.method&Webhooks.OnMemberRemoved.Format=webhooks.on_member_removed.format&Webhooks.OnMemberRemoved.Method=webhooks.on_member_removed.method&Webhooks.OnMessageRemove.Format=webhooks.on_message_remove.format&Webhooks.OnMessageRemove.Method=webhooks.on_message_remove.method&Webhooks.OnMessageUpdate.Format=webhooks.on_message_update.format&Webhooks.OnMessageUpdate.Method=webhooks.on_message_update.method&Notifications.NewMessage.Enabled=false&Webhooks.OnChannelDestroy.Format=webhooks.on_channel_destroy.format&Webhooks.OnChannelDestroy.Method=webhooks.on_channel_destroy.method&Webhooks.OnChannelUpdated.Format=webhooks.on_channel_updated.format&Webhooks.OnChannelUpdated.Method=webhooks.on_channel_updated.method&Webhooks.OnMessageRemoved.Format=webhooks.on_message_removed.format&Webhooks.OnMessageRemoved.Method=webhooks.on_message_removed.method&Webhooks.OnMessageUpdated.Format=webhooks.on_message_updated.format&Webhooks.OnMessageUpdated.Method=webhooks.on_message_updated.method&Notifications.NewMessage.Template=notifications.new_message.template&Webhooks.OnChannelDestroyed.Format=webhooks.on_channel_destroyed.format&Webhooks.OnChannelDestroyed.Method=webhooks.on_channel_destroyed.method&Notifications.AddedToChannel.Enabled=false&Notifications.AddedToChannel.Template=notifications.added_to_channel.template&Notifications.InvitedToChannel.Enabled=false&Notifications.InvitedToChannel.Template=notifications.invited_to_channel.template&Notifications.RemovedFromChannel.Enabled=false&Notifications.RemovedFromChannel.Template=notifications.removed_from_channel.template'

Request example

{"FriendlyName"=>"friendly_name", "PreWebhookUrl"=>"pre_webhook_url", "WebhookMethod"=>"webhook_method", "PostWebhookUrl"=>"post_webhook_url", "WebhookFilters"=>["webhook_filters"], "ReadStatusEnabled"=>false, "Limits.UserChannels"=>500, "ReachabilityEnabled"=>false, "DefaultChannelRoleSid"=>"RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "DefaultServiceRoleSid"=>"RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "Limits.ChannelMembers"=>600, "TypingIndicatorTimeout"=>100, "Webhooks.OnMemberAdd.Url"=>"webhooks.on_member_add.url", "ConsumptionReportInterval"=>100, "Webhooks.OnChannelAdd.Url"=>"webhooks.on_channel_add.url", "Webhooks.OnMemberAdded.Url"=>"webhooks.on_member_added.url", "Webhooks.OnMessageSend.Url"=>"webhooks.on_message_send.url", "Webhooks.OnMessageSent.Url"=>"webhooks.on_message_sent.url", "Webhooks.OnChannelAdded.Url"=>"webhooks.on_channel_added.url", "Webhooks.OnMemberAdd.Format"=>"webhooks.on_member_add.format", "Webhooks.OnMemberAdd.Method"=>"webhooks.on_member_add.method", "Webhooks.OnMemberRemove.Url"=>"webhooks.on_member_remove.url", "DefaultChannelCreatorRoleSid"=>"RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "Webhooks.OnChannelAdd.Format"=>"webhooks.on_channel_add.format", "Webhooks.OnChannelAdd.Method"=>"webhooks.on_channel_add.method", "Webhooks.OnChannelUpdate.Url"=>"webhooks.on_channel_update.url", "Webhooks.OnMemberRemoved.Url"=>"webhooks.on_member_removed.url", "Webhooks.OnMessageRemove.Url"=>"webhooks.on_message_remove.url", "Webhooks.OnMessageUpdate.Url"=>"webhooks.on_message_update.url", "Webhooks.OnChannelDestroy.Url"=>"webhooks.on_channel_destroy.url", "Webhooks.OnChannelUpdated.Url"=>"webhooks.on_channel_updated.url", "Webhooks.OnMemberAdded.Format"=>"webhooks.on_member_added.format", "Webhooks.OnMemberAdded.Method"=>"webhooks.on_member_added.method", "Webhooks.OnMessageRemoved.Url"=>"webhooks.on_message_removed.url", "Webhooks.OnMessageSend.Format"=>"webhooks.on_message_send.format", "Webhooks.OnMessageSend.Method"=>"webhooks.on_message_send.method", "Webhooks.OnMessageSent.Format"=>"webhooks.on_message_sent.format", "Webhooks.OnMessageSent.Method"=>"webhooks.on_message_sent.method", "Webhooks.OnMessageUpdated.Url"=>"webhooks.on_message_updated.url", "Webhooks.OnChannelAdded.Format"=>"webhooks.on_channel_added.format", "Webhooks.OnChannelAdded.Method"=>"webhooks.on_channel_added.method", "Webhooks.OnMemberRemove.Format"=>"webhooks.on_member_remove.format", "Webhooks.OnMemberRemove.Method"=>"webhooks.on_member_remove.method", "Webhooks.OnChannelDestroyed.Url"=>"webhooks.on_channel_destroyed.url", "Webhooks.OnChannelUpdate.Format"=>"webhooks.on_channel_update.format", "Webhooks.OnChannelUpdate.Method"=>"webhooks.on_channel_update.method", "Webhooks.OnMemberRemoved.Format"=>"webhooks.on_member_removed.format", "Webhooks.OnMemberRemoved.Method"=>"webhooks.on_member_removed.method", "Webhooks.OnMessageRemove.Format"=>"webhooks.on_message_remove.format", "Webhooks.OnMessageRemove.Method"=>"webhooks.on_message_remove.method", "Webhooks.OnMessageUpdate.Format"=>"webhooks.on_message_update.format", "Webhooks.OnMessageUpdate.Method"=>"webhooks.on_message_update.method", "Notifications.NewMessage.Enabled"=>false, "Webhooks.OnChannelDestroy.Format"=>"webhooks.on_channel_destroy.format", "Webhooks.OnChannelDestroy.Method"=>"webhooks.on_channel_destroy.method", "Webhooks.OnChannelUpdated.Format"=>"webhooks.on_channel_updated.format", "Webhooks.OnChannelUpdated.Method"=>"webhooks.on_channel_updated.method", "Webhooks.OnMessageRemoved.Format"=>"webhooks.on_message_removed.format", "Webhooks.OnMessageRemoved.Method"=>"webhooks.on_message_removed.method", "Webhooks.OnMessageUpdated.Format"=>"webhooks.on_message_updated.format", "Webhooks.OnMessageUpdated.Method"=>"webhooks.on_message_updated.method", "Notifications.NewMessage.Template"=>"notifications.new_message.template", "Webhooks.OnChannelDestroyed.Format"=>"webhooks.on_channel_destroyed.format", "Webhooks.OnChannelDestroyed.Method"=>"webhooks.on_channel_destroyed.method", "Notifications.AddedToChannel.Enabled"=>false, "Notifications.AddedToChannel.Template"=>"notifications.added_to_channel.template", "Notifications.InvitedToChannel.Enabled"=>false, "Notifications.InvitedToChannel.Template"=>"notifications.invited_to_channel.template", "Notifications.RemovedFromChannel.Enabled"=>false, "Notifications.RemovedFromChannel.Template"=>"notifications.removed_from_channel.template"}

Response examples (200)

{
  "sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://ip-messaging.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "links": {
    "roles": "https://ip-messaging.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles",
    "users": "https://ip-messaging.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users",
    "channels": "https://ip-messaging.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels"
  },
  "limits": {
    "user_channels": 600,
    "channel_members": 500
  },
  "webhooks": {
    "on_member_add": {
      "url": "webhooks.on_member_add.url",
      "format": "webhooks.on_member_add.format",
      "method": "webhooks.on_member_add.method"
    },
    "on_channel_add": {
      "url": "webhooks.on_channel_add.url",
      "format": "webhooks.on_channel_add.format",
      "method": "webhooks.on_channel_add.method"
    },
    "on_member_added": {
      "url": "webhooks.on_member_added.url",
      "format": "webhooks.on_member_added.format",
      "method": "webhooks.on_member_added.method"
    },
    "on_message_send": {
      "url": "webhooks.on_message_send.url",
      "format": "webhooks.on_message_send.format",
      "method": "webhooks.on_message_send.method"
    },
    "on_message_sent": {
      "url": "webhooks.on_message_sent.url",
      "format": "webhooks.on_message_sent.format",
      "method": "webhooks.on_message_sent.method"
    },
    "on_channel_added": {
      "url": "webhooks.on_channel_added.url",
      "format": "webhooks.on_channel_added.format",
      "method": "webhooks.on_channel_added.method"
    },
    "on_member_remove": {
      "url": "webhooks.on_member_remove.url",
      "format": "webhooks.on_member_remove.format",
      "method": "webhooks.on_member_remove.method"
    },
    "on_channel_update": {
      "url": "webhooks.on_channel_update.url",
      "format": "webhooks.on_channel_update.format",
      "method": "webhooks.on_channel_update.method"
    },
    "on_member_removed": {
      "url": "webhooks.on_member_removed.url",
      "format": "webhooks.on_member_removed.format",
      "method": "webhooks.on_member_removed.method"
    },
    "on_message_remove": {
      "url": "webhooks.on_message_remove.url",
      "format": "webhooks.on_message_remove.format",
      "method": "webhooks.on_message_remove.method"
    },
    "on_message_update": {
      "url": "webhooks.on_message_update.url",
      "format": "webhooks.on_message_update.format",
      "method": "webhooks.on_message_update.method"
    },
    "on_channel_destroy": {
      "url": "webhooks.on_channel_destroy.url",
      "format": "webhooks.on_channel_destroy.format",
      "method": "webhooks.on_channel_destroy.method"
    },
    "on_channel_updated": {
      "url": "webhooks.on_channel_updated.url",
      "format": "webhooks.on_channel_updated.format",
      "method": "webhooks.on_channel_updated.method"
    },
    "on_message_removed": {
      "url": "webhooks.on_message_removed.url",
      "format": "webhooks.on_message_removed.format",
      "method": "webhooks.on_message_removed.method"
    },
    "on_message_updated": {
      "url": "webhooks.on_message_updated.url",
      "format": "webhooks.on_message_updated.format",
      "method": "webhooks.on_message_updated.method"
    },
    "on_channel_destroyed": {
      "url": "webhooks.on_channel_destroyed.url",
      "format": "webhooks.on_channel_destroyed.format",
      "method": "webhooks.on_channel_destroyed.method"
    }
  },
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2015-07-30T20:00:00Z",
  "date_updated": "2015-07-30T20:00:00Z",
  "friendly_name": "friendly_name",
  "notifications": {
    "new_message": {
      "enabled": false,
      "template": "notifications.new_message.template"
    },
    "added_to_channel": {
      "enabled": false,
      "template": "notifications.added_to_channel.template"
    },
    "invited_to_channel": {
      "enabled": false,
      "template": "notifications.invited_to_channel.template"
    },
    "removed_from_channel": {
      "enabled": false,
      "template": "notifications.removed_from_channel.template"
    }
  },
  "webhook_method": "webhook_method",
  "pre_webhook_url": "pre_webhook_url",
  "webhook_filters": [
    "webhook_filters"
  ],
  "post_webhook_url": "post_webhook_url",
  "read_status_enabled": false,
  "reachability_enabled": false,
  "default_channel_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "default_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "typing_indicator_timeout": 100,
  "consumption_report_interval": 100,
  "default_channel_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}