# Updates the given properties of a Sim resource on your Account.

**POST /v1/Sims/{Sid}**

Updates the given properties of a Sim resource on your Account.
A resource representing a Programmable Wireless SIM

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


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **Sid** (string)
  The SID or the `unique_name` of the Sim resource to update.


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

- **UniqueName** (string)
  An application-defined string that uniquely identifies the resource. It can be used in place of the `sid` in the URL path to address the resource.
- **CallbackMethod** (string(http-method))
  The HTTP method we should use to call `callback_url`. Can be: `POST` or `GET`. The default is `POST`.
- **CallbackUrl** (string(uri))
  The URL we should call using the `callback_url` when the SIM has finished updating. When the SIM transitions from `new` to `ready` or from any status to `deactivated`, we call this URL when the status changes to an intermediate status (`ready` or `deactivated`) and again when the status changes to its final status (`active` or `canceled`).
- **FriendlyName** (string)
  A descriptive string that you create to describe the Sim resource. It does not need to be unique.
- **RatePlan** (string)
  The SID or unique name of the [RatePlan resource](https://www.twilio.com/docs/iot/wireless/api/rateplan-resource) to which the Sim resource should be assigned.
- **Status** (string)
  The status of the Sim resource. Can be: `new`, `ready`, `active`, `deactivated`, `canceled`, `deleted`, `scheduled`, or `updating`. See [Status Values](https://www.twilio.com/docs/iot/wireless/api/sim-resource#status-values) for the description of each status.
- **CommandsCallbackMethod** (string(http-method))
  The HTTP method we should use to call `commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.
- **CommandsCallbackUrl** (string(uri))
  The URL we should call using the `commands_callback_method` when the SIM sends a [Command](https://www.twilio.com/docs/iot/wireless/api/command-resource). Your server should respond with an HTTP status code in the 200 range; any response body is ignored.
- **SmsFallbackMethod** (string(http-method))
  The HTTP method we should use to call `sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
- **SmsFallbackUrl** (string(uri))
  The URL we should call using the `sms_fallback_method` when an error occurs while retrieving or executing the TwiML requested from `sms_url`.
- **SmsMethod** (string(http-method))
  The HTTP method we should use to call `sms_url`. Can be: `GET` or `POST`. Default is `POST`.
- **SmsUrl** (string(uri))
  The URL we should call using the `sms_method` when the SIM-connected device sends an SMS message that is not a [Command](https://www.twilio.com/docs/iot/wireless/api/command-resource).
- **VoiceFallbackMethod** (string(http-method))
  Deprecated.
- **VoiceFallbackUrl** (string(uri))
  Deprecated.
- **VoiceMethod** (string(http-method))
  Deprecated.
- **VoiceUrl** (string(uri))
  Deprecated.
- **ResetStatus** (string)
  The connectivity reset status of the SIM. Can be: null or `resetting`. When a connectivity reset is initiated on a SIM, this property is `resetting`. After the reset completes, it is null.
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) to which the Sim resource should belong. The Account SID can only be that of the requesting Account or that of a [Subaccount](https://www.twilio.com/docs/iam/api/subaccounts) of the requesting Account. Only valid when the Sim resource's status is `new`. For more information, see the [Move SIMs between Subaccounts documentation](https://www.twilio.com/docs/iot/wireless/api/sim-resource#move-sims-between-subaccounts).


## 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 Sim resource.
- **unique_name** (string | null)
  An application-defined string that uniquely identifies the resource. It can be used in place of the resource's `sid` in the URL to address the resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) to which the Sim resource belongs.
- **rate_plan_sid** (string | null)
  The SID of the [RatePlan resource](https://www.twilio.com/docs/iot/wireless/api/rateplan-resource) to which the Sim resource is assigned.
- **friendly_name** (string | null)
  The string that you assigned to describe the Sim resource.
- **iccid** (string | null)
  The [ICCID](https://en.wikipedia.org/wiki/SIM_card#ICCID) associated with the SIM.
- **e_id** (string | null)
  Deprecated.
- **status** (string)
  The status of the Sim resource. Can be: `new`, `ready`, `active`, `deactivated`, `canceled`, `deleted`, `scheduled`, or `updating`. See [Status Values](https://www.twilio.com/docs/iot/wireless/api/sim-resource#status-values) for the description of each status.
- **reset_status** (string)
  The connectivity reset status of the SIM. Can be: null or `resetting`. When a connectivity reset is initiated on a SIM, this property is `resetting`. After the reset completes, it is null.
- **commands_callback_url** (string(uri) | null)
  The URL we call using the `commands_callback_method` when the SIM originates a machine-to-machine [Command](https://www.twilio.com/docs/iot/wireless/api/command-resource). Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
- **commands_callback_method** (string(http-method) | null)
  The HTTP method we use to call `commands_callback_url`.  Can be: `POST` or `GET`. Default is `POST`.
- **sms_fallback_method** (string(http-method) | null)
  Deprecated.
- **sms_fallback_url** (string(uri) | null)
  Deprecated.
- **sms_method** (string(http-method) | null)
  Deprecated.
- **sms_url** (string(uri) | null)
  Deprecated.
- **voice_fallback_method** (string(http-method) | null)
  Deprecated. The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
- **voice_fallback_url** (string(uri) | null)
  Deprecated. The URL we call using the `voice_fallback_method` when an error occurs while retrieving or executing the TwiML requested from `voice_url`.
- **voice_method** (string(http-method) | null)
  Deprecated. The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. Default is `POST`.
- **voice_url** (string(uri) | null)
  Deprecated. The URL we call using the `voice_method` when the SIM-connected device makes a voice call.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the Sim resource was last updated specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
- **url** (string(uri) | null)
  The absolute URL of the resource.
- **links** (object(uri-map) | null)
  The URLs of related subresources.
- **ip_address** (string | null)
  Deprecated.


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