# Update user

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


Unique chat users within a chat service

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


## Authentication methods
- Account sid auth token


## Parameters
### Headers
- **X-Twilio-Webhook-Enabled** (string)
  The X-Twilio-Webhook-Enabled HTTP request header

### Path parameters
- **ServiceSid** (string)
  The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) to update the User resource in.
- **Sid** (string)
  The SID of the User resource to update. This value can be either the `sid` or the `identity` of the User resource to update.


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

- **RoleSid** (string)
  The SID of the [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the User.
- **Attributes** (string)
  A valid JSON string that contains application-specific data.
- **FriendlyName** (string)
  A descriptive string that you create to describe the resource. It is often used for display purposes.


## 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 User resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User resource.
- **service_sid** (string | null)
  The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User resource is associated with.
- **attributes** (string | null)
  The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **role_sid** (string | null)
  The SID of the [Role](https://www.twilio.com/docs/chat/rest/role-resource) assigned to the user.
- **identity** (string | null)
  The application-defined string that uniquely identifies the resource's User within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). This value is often a username or an email address, and is case-sensitive. See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info.
- **is_online** (boolean | null)
  Whether the User is actively connected to the Service instance and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service's `reachability_enabled` is `false`, if the User has never been online for the Service instance, even if the Service's `reachability_enabled` is `true`.
- **is_notifiable** (boolean | null)
  Whether the User has a potentially valid Push Notification registration (APN or GCM) for the Service instance. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service's `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service's `reachability_enabled` is `true`.
- **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.
- **joined_channels_count** (integer)
  The number of Channels the User is a Member of.
- **links** (object(uri-map) | null)
  The absolute URLs of the [Channel](https://www.twilio.com/docs/chat/channels) and [Binding](https://www.twilio.com/docs/chat/rest/binding-resource) resources related to the user.
- **url** (string(uri) | null)
  The absolute URL of the User resource.


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