Request information needed to clear existing recovery codes.

Request information needed to disable two step verification.

A array of nicknames of credentials to be deleted.

A re-authentication token redeemable for any password check.

Response parameters for initiating enabling authenticator-based two step verification.

The manual entry key to input into the authenticator app.

The Url to the QR code image to scan into the authenticator app.

The setup token for turning on authenticator.

Response parameters for initiating enabling security key-based two step verification.

The credential registration options for the hardware key.

Request parameters for enabling two step verification.

Request parameters for authenticator enabling-verify.

The setup token from the enable authenticator request.

Response parameters for finishing enabling authenticator-based two-step verification.

Recovery codes automatically generated for the user (when applicable; the user should
not already have a set of recovery codes).

Request information needed to complete the registration of a security key.

Response parameters for listing all credentials under a user.

Number of characters in an authenticator-based two step verification code.

Address of the help site provided to users to help them with authenticator.

Number of characters in an email-based two step verification code.

Whether Android security keys is enabled.

Whether or not someone can enable authenticator with just a verified phone number.

Whether or not a password is required for making updates to recovery codes.

Whether or not a password is required for disabling authenticator.

Whether or not a password is required for disabling email 2sv.

Whether or not a password is required for disabling SMS 2SV.

Whether or not a password is required for enabling authenticator.

Whether or not a password is required for enabling email 2sv.

Whether or not a password is required for enabling Security Key 2SV.

Whether or not a password is required for enabling SMS 2SV.

Whether recovery code generation is attempted upon completion of authenticator setup.

Whether security keys on all platforms is enabled.

Whether or not security key two step verification is available for the user.

Whether or not the frontend should enforce single method logic.

Whether or not sms two step verification is available for the user.

Whether or not a 2sv method has to be enabled to require password when enabling authenticator.

Whether or not a 2sv method has to be enabled to require password when enabling email two step verification.

Whether or not we're using the new 2sv webview component or the manual pop up

Whether users should receive additional warnings when disabling 2SV.

Whether or not two step verification is globally enabled.

The response for getting the status of recovery codes for a user.

The number of unused recovery codes the user has available.

The date time the recovery codes were generated at.

Request information needed to regenerate recovery codes.

The response for regenerating recovery codes.

The collection of generated recovery codes.

Request parameters for retracting a Cross Device dialog from state ACTIVE to PENDING.

The Roblox.TwoStepVerification.Client.TwoStepVerificationActionType associated with the challenge. ['Unknown' = 0, 'Login' = 1, 'RobuxSpend' = 2, 'ItemTrade' = 3, 'Resale' = 4, 'PasswordReset' = 5, 'RevertAccount' = 6, 'Generic' = 7, 'GenericWithRecoveryCodes' = 8]

Result for a successful attempt to retract a Cross Device state from ACTIVE to PENDING.

Request parameters for retrying a Cross Device two step verification approval.

Result for a successful Cross Device approval retry, an empty JSON.

Credential information that includes its nickname and any additional metadata.

Nickname the user has chosen for this credential.

Request parameters for sending a two step verification code.

The users two step verification configuration.

The two step verification methods associated with the user.

The preferred two step verification method for the user.

The Roblox.TwoStepVerification.Client.TwoStepVerificationMediaType for the method. ['Email' = 0, 'SMS' = 1, 'Authenticator' = 2, 'RecoveryCode' = 3, 'SecurityKey' = 4, 'CrossDevice' = 5, 'Password' = 6, 'Passkey' = 7]

The last time this method was updated for the user.

Request parameters for verifying a Cross Device two step verification approval. Does not use verification code.

Result for a successful Cross Device approval verification.

Request parameters for verifying a two step verification code.

The authentication options for the passkey.

The session of the authentication attempt.

The authentication options for the hardware key.

TwoStepVerification Api v1

The metadata endpoint takes in optional request parameters to output additional context
for when the user is unauthenticated but attempting to login with two step verification.

When supplied, all three request parameters must be sent and match up.

userId

The active two step verification challenge ID if there is one.

challengeId

The Roblox.TwoStepVerification.Client.TwoStepVerificationActionType associated with the challenge.

actionType

Gets two step verification system metadata.

The Roblox.TwoStepVerification.Api.VerifyCodeRequest.

request

1: Invalid challenge ID.
2: The user ID is invalid.
10: The two step verification challenge code is invalid.

7: Two step verification is currently under maintenance.

Verifies a two step verification challenge code via authenticator app.

The Roblox.TwoStepVerification.Api.RetractDialogRequest.

1: Invalid challenge ID.
2: The user ID is invalid.

0: Token Validation Failed
19: Challenge denied.

Reverts a user's dialog state from ACTIVE to PENDING.

The Roblox.TwoStepVerification.Api.RetryApprovalRequest.

Retry a Cross Device two step verification approval.

The Roblox.TwoStepVerification.Api.VerifyApprovalRequest.

0: An unknown error occurred with the request.
1: Invalid challenge ID.
2: The user ID is invalid.

Verifies a two step verification approval via Cross Device. Cross Device approval does not use a verification code.

The request body.Roblox.TwoStepVerification.Api.SendCodeRequest.

0: Token Validation Failed
2: The user ID is invalid.

Sends a two step verification challenge code via email.

The request body.Roblox.TwoStepVerification.Api.VerifyCodeRequest.

1: Invalid challenge ID.
10: The two step verification challenge code is invalid.

Verifies a two step verification challenge with a code sent via email.

The request bodyRoblox.TwoStepVerification.Api.VerifyCodeRequest.

Validates the assertion data returned by the passkey.

The request bodyRoblox.TwoStepVerification.Api.SendCodeRequest.

0: Token Validation Failed
8: The user is not allowed to perform the requested action.

Provides a challenge for the passkey to authenticate.

1: Invalid challenge ID.
4: The password is invalid.

Verifies a two step verification challenge with a password (code).

Once a recovery code has been used to verify a challenge it cannot be used again.

Verifies a two step verification challenge via a recovery code.

Validates the assertion data returned by the security key.

Provides a challenge for the security key to authenticate.

Sends a two step verification code via SMS for the specified user.

Verifies a two step verification challenge with a code sent via SMS.

The Id of the user to get the configuration for.

The active challenge for the user (as an alternative when the user is unauthenticated).

The action type the challengeId is associated with.

Gets two step verification configuration for the specified user.

The Roblox.TwoStepVerification.Api.DisableTwoStepVerificationRequest.

2: The user ID is invalid.
4: The password is invalid.

0: Authorization has been denied for this request.

0: Token Validation Failed
6: The account pin is locked.
8: The user is not allowed to perform the requested action.

Disables two step verification via authenticator for the specified user.

The Roblox.TwoStepVerification.Api.EnableTwoStepVerificationRequest.

2: The user ID is invalid.
3: The email is invalid.
4: The password is invalid.

0: Token Validation Failed
6: The account pin is locked.
11: The two step verification configuration is already enabled.

Initiates enabling authenticator-based two step verification for the specified user.

Enabling authenticator-based two step verification requires two parts to help ensure
the user has properly stored the authenticator key in their authenticator app.

The Roblox.TwoStepVerification.Api.EnableVerifyAuthenticatorRequest.

2: The user ID is invalid.
4: The password is invalid.
10: The two step verification challenge code is invalid.
12: Invalid setup token.

0: Token Validation Failed
11: The two step verification configuration is already enabled.

Finishes enabling authenticator-based two step verification for the specified user.

0: Token Validation Failed
2: The user ID is invalid.
6: The account pin is locked.
8: The user is not allowed to perform the requested action.

Disables two step verification via email for the specified user.

3: The email is invalid.
4: The password is invalid.

0: Token Validation Failed
2: The user ID is invalid.
6: The account pin is locked.

Enables two step verification via email for the specified user.

The request bodyRoblox.TwoStepVerification.Api.DisableTwoStepVerificationRequest.

Disables a batch of credentials for the specified user.

The request body.Roblox.TwoStepVerification.Api.EnableTwoStepVerificationRequest.

0: Token Validation Failed
9: The two step verification configuration is invalid for this action.
16: Reached limit of security keys registered.

Initiates security key registration by providing credential creation options.

The request body.Roblox.TwoStepVerification.Api.EnableVerifySecurityKeyRequest.

2: The user ID is invalid.
17: Invalid security key nickname.

0: Token Validation Failed
17: Invalid security key nickname.

Finishes security key registration and stores credential. Enables security key as a 2sv media type if it is a user's first key.

The request body.Roblox.TwoStepVerification.Api.DisableTwoStepVerificationRequest.

Disables two step verification via SMS for the specified user.

4: The password is invalid.
15: The phone number is invalid.

7: Two step verification is currently under maintenance.
8: The user is not allowed to perform the requested action.

Enables two step verification via SMS for the specified user.

Gets the current status of recovery codes for a user.

Clearing recovery codes voids any recovery codes previously generated for the user.
New recovery codes will have to be generated to pass two step verification via recovery code.

The Roblox.TwoStepVerification.Api.ClearRecoveryCodesRequest.

0: Token Validation Failed
6: The account pin is locked.

Clears any existing recovery codes for the user.

Two step verification recovery codes do not enforce that two step verification must be passed when logging in.
At least one two step verification media type must be enabled to trigger the two step verification flow.
Recovery codes are intended to be used to pass two step verification when the enabled media type is unavailable.

Recovery codes generated by this endpoint do not have an expiration.

Once a recovery code generated by this endpoint has been used it cannot be used again.

The user ID to generate recovery codes for.

The Roblox.TwoStepVerification.Api.RegenerateRecoveryCodesRequest.

Clears any existing recovery codes and generates a new batch of recovery codes.

Visão geral

Experiências

Avatar

Ativos

Open Cloud

Create

Descoberta

Localização

Dados analíticos

Design

Scale

Affiliates

Monetize

Este método é assíncrono e retorna uma "Operação", que representa o estado atual da operação. Ele contém um caminho de endpoint que você pode solicitar para obter a resposta real e os metadados aplicáveis. Veja o [documentation]({longRunningOperationsLink}) em operações de longo prazo para obter mais informações.
            
As seções a seguir descrevem os objetos de resposta e metadados que são fornecidos quando uma operação se completa.

Pontos de extremidade beta estão prontos para uso público. Alterações  danosas são possíveis mas raras.

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Esses campos podem ser definidos ao criar um recurso, mas não podem ser modificados por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que seu aplicativo OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão de aplicativos]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Concede a capacidade de atualizar emblemas de propriedade do usuário.

Isso permite visualizar informações sobre seus itens de comércio.

Isso permite editar suas conexões de comerciante.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite visualizar informações sobre suas comunidades

Isso permite que você gerencie solicitações de participação na comunidade e atualizações de cargos de membros da comunidade de níveis inferiores para sua conta.

Isto permite visualizar informações sobre seu inventário.

Concede acesso para gerenciar seus emblemas.

Concede acesso para gerenciar seus emblemas e gastar Robux.

Concede acesso para gerenciar seus produtos de desenvolvedor.

Concede acesso para ler informações sobre as experiências que você segue.

Concede acesso para seguir e deixar de seguir experiências em seu nome.

Concede acesso para gerenciar seus passes.

Concede acesso para gerenciar suas comunidades.

Concede permissão para ler informações da comunidade.

Concede permissões de gerenciamento de comunidade.

Concede acesso para ler e escrever suas tabelas de localização

Concede acesso para gerenciar a colaboração de equipe para todas as experiências que você possui.

Concede acesso para gerenciar suas experiências e certas informações associadas a suas experiências (por exemplo, informações de localização).

Concede acesso para ler as informações de localização das suas experiências.

Concede acesso para modificar as preferências de localização das suas experiências.

Concede acesso para gerenciar sua conta de usuário.

Concede acesso para modificar as preferências de localização do usuário.

Isto permite publicar mensagens em nome de um usuário.

Isto permite o envio de notificações da sua experiência aos usuários.

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Concede acesso para ler sobre seus produtos de assinatura.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de entrada única.

Isso permite acesso à leitura das informações do seu perfil.

Two-step verification v1