# Update a specific Factor. This endpoint can be used to Verify a Factor if passed an `AuthPayload` param.

**POST /v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}**

Update a specific Factor. This endpoint can be used to Verify a Factor if passed an `AuthPayload` param.


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


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The unique SID identifier of the Service.
- **Identity** (string)
  Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
- **Sid** (string)
  A 34 character string that uniquely identifies this Factor.


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

- **AuthPayload** (string)
  The optional payload needed to verify the Factor for the first time. E.g. for a TOTP, the numeric code.
- **FriendlyName** (string)
  The new friendly name of this Factor. It can be up to 64 characters.
- **Config.NotificationToken** (string)
  For APN, the device token. For FCM, the registration token. It is used to send the push notifications. Required when `factor_type` is `push`. If specified, this value must be between 32 and 255 characters long.
- **Config.SdkVersion** (string)
  The Verify Push SDK version used to configure the factor
- **Config.TimeStep** (integer)
  Defines how often, in seconds, are TOTP codes generated. i.e, a new TOTP code is generated every time_step seconds. Must be between 20 and 60 seconds, inclusive
- **Config.Skew** (integer)
  The number of time-steps, past and future, that are valid for validation of TOTP codes. Must be between 0 and 2, inclusive
- **Config.CodeLength** (integer)
  Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive
- **Config.Alg** (string)

- **Config.NotificationPlatform** (string)
  The transport technology used to generate the Notification Token. Can be `apn`, `fcm` or `none`.

  Required when `factor_type` is `push`.


## Responses
### 200
OK
#### Headers
- **Twilio-Verify-Factor-Signature** (string)

- **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)
  A 34 character string that uniquely identifies this Factor.
- **account_sid** (string | null)
  The unique SID identifier of the Account.
- **service_sid** (string | null)
  The unique SID identifier of the Service.
- **entity_sid** (string | null)
  The unique SID identifier of the Entity.
- **identity** (string | null)
  Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
- **date_created** (string(date-time) | null)
  The date that this Factor was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date that this Factor was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **friendly_name** (string | null)
  A human readable description of this resource, up to 64 characters. For a push factor, this can be the device's name.
- **status** (string)
  The Status of this Factor. One of `unverified` or `verified`.
- **factor_type** (string)
  The Type of this Factor. Currently `push` and `totp` are supported.
- **config** ()
  An object that contains configurations specific to a `factor_type`.
- **metadata** ()
  Custom metadata associated with the factor. This is added by the Device/SDK directly to allow for the inclusion of device information. It must be a stringified JSON with only strings values eg. `{"os": "Android"}`. Can be up to 1024 characters in length.
- **url** (string(uri) | null)
  The URL of this resource.


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