# Update service

**POST /v2/Services/{Sid}**


Top level scope for all chat resources

## Servers
- https://chat.twilio.com: https://chat.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **Sid** (string)
  The SID of the Service resource to update.


### Body: application/x-www-form-urlencoded (object)

- **FriendlyName** (string)
  A descriptive string that you create to describe the resource.
- **DefaultServiceRoleSid** (string)
  The service role assigned to users when they are added to the service. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **DefaultChannelRoleSid** (string)
  The channel role assigned to users when they are added to a channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **DefaultChannelCreatorRoleSid** (string)
  The channel role assigned to a channel creator when they join a new channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **ReadStatusEnabled** (boolean)
  Whether to enable the [Message Consumption Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature. The default is `true`.
- **ReachabilityEnabled** (boolean)
  Whether to enable the [Reachability Indicator](https://www.twilio.com/docs/chat/reachability-indicator) for this Service instance. The default is `false`.
- **TypingIndicatorTimeout** (integer)
  How long in seconds after a `started typing` event until clients should assume that user is no longer typing, even if no `ended typing` message was received.  The default is 5 seconds.
- **ConsumptionReportInterval** (integer)
  DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints.
- **Notifications.NewMessage.Enabled** (boolean)
  Whether to send a notification when a new message is added to a channel. The default is `false`.
- **Notifications.NewMessage.Template** (string)
  The template to use to create the notification text displayed when a new message is added to a channel and `notifications.new_message.enabled` is `true`.
- **Notifications.NewMessage.Sound** (string)
  The name of the sound to play when a new message is added to a channel and `notifications.new_message.enabled` is `true`.
- **Notifications.NewMessage.BadgeCountEnabled** (boolean)
  Whether the new message badge is enabled. The default is `false`.
- **Notifications.AddedToChannel.Enabled** (boolean)
  Whether to send a notification when a member is added to a channel. The default is `false`.
- **Notifications.AddedToChannel.Template** (string)
  The template to use to create the notification text displayed when a member is added to a channel and `notifications.added_to_channel.enabled` is `true`.
- **Notifications.AddedToChannel.Sound** (string)
  The name of the sound to play when a member is added to a channel and `notifications.added_to_channel.enabled` is `true`.
- **Notifications.RemovedFromChannel.Enabled** (boolean)
  Whether to send a notification to a user when they are removed from a channel. The default is `false`.
- **Notifications.RemovedFromChannel.Template** (string)
  The template to use to create the notification text displayed to a user when they are removed from a channel and `notifications.removed_from_channel.enabled` is `true`.
- **Notifications.RemovedFromChannel.Sound** (string)
  The name of the sound to play to a user when they are removed from a channel and `notifications.removed_from_channel.enabled` is `true`.
- **Notifications.InvitedToChannel.Enabled** (boolean)
  Whether to send a notification when a user is invited to a channel. The default is `false`.
- **Notifications.InvitedToChannel.Template** (string)
  The template to use to create the notification text displayed when a user is invited to a channel and `notifications.invited_to_channel.enabled` is `true`.
- **Notifications.InvitedToChannel.Sound** (string)
  The name of the sound to play when a user is invited to a channel and `notifications.invited_to_channel.enabled` is `true`.
- **PreWebhookUrl** (string(uri))
  The URL for pre-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **PostWebhookUrl** (string(uri))
  The URL for post-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **WebhookMethod** (string(http-method))
  The HTTP method to use for calls to the `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and the default is `POST`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **WebhookFilters** (array[string])
  The list of webhook events that are enabled for this Service instance. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **Limits.ChannelMembers** (integer)
  The maximum number of Members that can be added to Channels within this Service. Can be up to 1,000.
- **Limits.UserChannels** (integer)
  The maximum number of Channels Users can be a Member of within this Service. Can be up to 1,000.
- **Media.CompatibilityMessage** (string)
  The message to send when a media message has no text. Can be used as placeholder message.
- **PreWebhookRetryCount** (integer)
  The number of times to retry a call to the `pre_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means the call won't be retried.
- **PostWebhookRetryCount** (integer)
  The number of times to retry a call to the `post_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. The default is 0, which means the call won't be retried.
- **Notifications.LogEnabled** (boolean)
  Whether to log notifications. The default is `false`.


## Responses
### 200
OK
#### Headers
- **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

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Service resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **default_service_role_sid** (string | null)
  The service role assigned to users when they are added to the service. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **default_channel_role_sid** (string | null)
  The channel role assigned to users when they are added to a channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **default_channel_creator_role_sid** (string | null)
  The channel role assigned to a channel creator when they join a new channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles.
- **read_status_enabled** (boolean | null)
  Whether the [Message Consumption Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature is enabled. The default is `true`.
- **reachability_enabled** (boolean | null)
  Whether the [Reachability Indicator](https://www.twilio.com/docs/chat/reachability-indicator) is enabled for this Service instance. The default is `false`.
- **typing_indicator_timeout** (integer)
  How long in seconds after a `started typing` event until clients should assume that user is no longer typing, even if no `ended typing` message was received.  The default is 5 seconds.
- **consumption_report_interval** (integer)
  DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints.
- **limits** ()
  An object that describes the limits of the service instance. The `limits` object contains  `channel_members` to describe the members/channel limit and `user_channels` to describe the channels/user limit. `channel_members` can be 1,000 or less, with a default of 250. `user_channels` can be 1,000 or less, with a default value of 100.
- **pre_webhook_url** (string | null)
  The URL for pre-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **post_webhook_url** (string | null)
  The URL for post-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **webhook_method** (string | null)
  The HTTP method to use for calls to the `pre_webhook_url` and `post_webhook_url` webhooks.  Can be: `POST` or `GET` and the default is `POST`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **webhook_filters** (array[string] | null)
  The list of webhook events that are enabled for this Service instance. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details.
- **pre_webhook_retry_count** (integer)
  The number of times to retry a call to the `pre_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means the call won't be retried.
- **post_webhook_retry_count** (integer)
  The number of times to retry a call to the `post_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. The default is 0, which means the call won't be retried.
- **notifications** ()
  The notification configuration for the Service instance. See [Push Notification Configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info.
- **media** ()
  An object that describes the properties of media that the service supports. The object contains the `size_limit_mb` property, which describes the size of the largest media file in MB; and the `compatibility_message` property, which contains the message text to send when a media message does not have any text.
- **url** (string(uri) | null)
  The absolute URL of the Service resource.
- **links** (object(uri-map) | null)
  The absolute URLs of the Service's [Channels](https://www.twilio.com/docs/chat/channels), [Roles](https://www.twilio.com/docs/chat/rest/role-resource), [Bindings](https://www.twilio.com/docs/chat/rest/binding-resource), and [Users](https://www.twilio.com/docs/chat/rest/user-resource).


[Powered by Bump.sh](https://bump.sh)