---
title: "Update a specific Factor. This endpoint can be used to Verify a Factor if passed an `AuthPayload` param."
method: POST
path: "/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}"
tags: ["VerifyV2Factor"]
---

# 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.

## Path parameters

- `ServiceSid` string, required
- `Identity` string, required
- `Sid` string, required

## Response `200`

OK

- VerifyV2ServiceEntityFactor
  - `sid` string, nullable — A 34 character string that uniquely identifies this Factor.
  - `account_sid` string, nullable — The unique SID identifier of the Account.
  - `service_sid` string, nullable — The unique SID identifier of the Service.
  - `entity_sid` string, nullable — The unique SID identifier of the Entity.
  - `identity` string, nullable — 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, nullable — The date that this Factor was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date that this Factor was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `friendly_name` string, nullable — A human readable description of this resource, up to 64 characters. For a push factor, this can be the device's name.
  - `status` 'unverified' | 'verified' — The Status of this Factor. One of `unverified` or `verified`.
  - `factor_type` 'push' | 'totp' | 'passkeys' — The Type of this Factor. Currently `push` and `totp` are supported.
  - `config` unknown
  - `metadata` unknown
  - `url` string, uri, nullable — The URL of this resource.

## Changes

- **2025-08-18** (v2) `3fd4376faab5` — 1 warning
  - added the new `passkeys` enum value to the `factor_type` response property for the response status `200`
- **2025-07-03** (v2) `1548692e6804` — 2 breaking
  - the `config` response's property type changed from `object` to no type for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
- **2025-03-11** (v2) `43e0e113369c` — 2 breaking
  - the `config` response's property type changed from no type to `object` for status `200`
  - the `metadata` response's property type changed from no type to `object` for status `200`
- **2023-08-10** (v2) `fb6ded97d73f` — 1 info
  - api tag `VerifyV2Factor` added

[Change history](https://skmtc.dev/twilio/apis/verify-v2/changes/v2/Services/:ServiceSid/Entities/:Identity/Factors/:Sid/post.md)

---

[API](https://skmtc.dev/twilio/apis/verify-v2.md) · [All operations](https://skmtc.dev/twilio/apis/verify-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/verify-v2/revisions/10559c28858c?raw)