Prerequisites

Before using the Forgetme API, please note these prerequisites:

  • Logging must be enabled in your Mix application for your app ID.

  • Requests to Mix XaaS services must contain a user ID and/or session ID in order to be identified by ForgetMe.

    All services include an optional user_id request field, and DLGaaS returns the session_id in its Start response.

  • ForgetMe requests must use the same app ID used in the original XaaS requests.

  • ForgetMe requests must be sent to the same geography as the original XaaS request. If your solution spans multiple geographies, send a ForgetMe request to each geography that may contain a user’s data.

  • Your client ID needs the ForgetMe scope, log.forgetme, as described next.

Get scope for ForgetMe

In order to develop ForgetMe applications, you need to add the ForgetMe scope to your Nuance Mix account.

  1. Log into Mix.

  2. Click MANAGE at the top.

  3. Click Applications at the left. Information appears in the App ID box. If it doesn’t, click the Settings icon (Settings) at the left.

  4. In the App ID box, click the down arrow beside Client Name. You can use the default client, another existing client, or create a new client for this app ID.
    Your Client ID is displayed in the list, starting with appID:

  5. If you are creating a new client, click Generate Client Secret.
    Your Client Secret is displayed. Make a note of this value as it is not stored.

  6. Send your client ID to your Nuance representative to add the required scope, log.forgetme, to your account. (Ask your rep to create an internal Mix administration ticket to add the log.forgetme OAauth scope to your client ID.)

You will use these credentials—client ID, client secret, and scope—as part of the authorization process for calling ForgetMe.

Client credentials

URLs and scope

The URLs for ForgetMe in the hosted Mix environment are:

ForgetMe: log.api.nuance.com
Authorization: https://auth.crt.nuance.com/oauth2/token
Authorization scope: log.forgetme