# Update a specific Factor

**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.
TODO: Resource-level docs

## Servers



## 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:  (object)

- **AuthPayload** (string)
  The optional payload needed to verify the Factor for the first time. E.g. for a TOTP, the numeric code.
- **Config.Alg** (string)
  The algorithm used to derive the TOTP codes. Can be `sha1`, `sha256` or `sha512`
- **Config.CodeLength** (integer)
  Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive
- **Config.NotificationPlatform** (string)
  The transport technology used to generate the Notification Token. Can be `apn`, `fcm` or `none`.

  Required when `factor_type` is `push`.
- **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.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.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
- **FriendlyName** (string)
  The new friendly name of this Factor. It can be up to 64 characters.


## Responses
### 200
OK

#### Body:  (object)
- **account_sid** (string | null)
  Account Sid.
- **config** ()
  Configurations for a `factor_type`.
- **date_created** (string(date-time) | null)
  The date this Factor was created
- **date_updated** (string(date-time) | null)
  The date this Factor was updated
- **entity_sid** (string | null)
  Entity Sid.
- **factor_type** (string | null)
  The Type of this Factor
- **friendly_name** (string | null)
  A human readable description of this resource.
- **identity** (string | null)
  Unique external identifier of the Entity
- **metadata** ()
  Metadata of the factor.
- **service_sid** (string | null)
  Service Sid.
- **sid** (string | null)
  A string that uniquely identifies this Factor.
- **status** (null | string)
  The Status of this Factor
- **url** (string(uri) | null)
  The URL of this resource.


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