Update a specific Factor
TODO: Resource-level docs
Update a specific Factor. This endpoint can be used to Verify a Factor if passed an AuthPayload
param.
Path parameters
-
The unique SID identifier of the Service.
-
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.
-
A 34 character string that uniquely identifies this Factor.
Body
-
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
orsha512
Values are
sha1
,sha256
, orsha512
. -
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
ornone
.Required when
factor_type
ispush
. -
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
ispush
. 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.
curl \
-X POST https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid} \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'AuthPayload=string&Config.Alg=sha1&Config.CodeLength=42&Config.NotificationPlatform=string&Config.NotificationToken=string&Config.SdkVersion=string&Config.Skew=42&Config.TimeStep=42&FriendlyName=string'
{
"AuthPayload": "string",
"Config.Alg": "sha1",
"Config.CodeLength": 42,
"Config.NotificationPlatform": "string",
"Config.NotificationToken": "string",
"Config.SdkVersion": "string",
"Config.Skew": 42,
"Config.TimeStep": 42,
"FriendlyName": "string"
}
{
"AuthPayload": "string",
"Config.Alg": "sha1",
"Config.CodeLength": 42,
"Config.NotificationPlatform": "string",
"Config.NotificationToken": "string",
"Config.SdkVersion": "string",
"Config.Skew": 42,
"Config.TimeStep": 42,
"FriendlyName": "string"
}
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"entity_sid": "string",
"factor_type": "push",
"friendly_name": "string",
"identity": "string",
"service_sid": "string",
"sid": "string",
"status": "unverified",
"url": "https://example.com"
}
{
"account_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"entity_sid": "string",
"factor_type": "push",
"friendly_name": "string",
"identity": "string",
"service_sid": "string",
"sid": "string",
"status": "unverified",
"url": "https://example.com"
}