# Set the Default Subscription-Level Configuration
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/set-deflt-subsn-lev-config/index.md

## Overview {#overview}

A subscription is a license provided by RiskRecon to its customers. For more details on the subscriptions offered by RiskRecon, refer to the [Glossary](https://developer.mastercard.com/riskrecon-api/documentation/glossary/index.md) section.

The `PUT Subscription Level Config` endpoint allows you to set the default subscription-level configuration for the TOEs that you will add to your portfolio using the `POST Bulk Add` endpoint. Once you set the default subscription level configuration of your TOEs, you can exclude the `Subscription Level` parameter in the request body of the `POST Bulk Add` endpoint.

For more details on the `POST Bulk Add` endpoint, refer to the [Add TOEs in bulk to your Portfolio](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/add-bulk-toes/index.md) use case.

This subscription-level configuration value in the request body must be either of the following:

| Subscription-Level Configuration | Value in the Request Body |
|----------------------------------|---------------------------|
| RiskRecon Discover               | 1                         |
| RiskRecon Advisor                | 2                         |

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to set the default subscription level configuration for bulk TOE requests:
Diagram update-subscription-config

## Execution Steps {#execution-steps}

The following steps show how to set the default subscription level configuration for bulk TOE requests:

1. The user sends a `PUT` request to set the default subscription level configuration for bulk TOE requests.
2. RiskRecon sets the default subscription level configuration for the TOEs.

## Sample Request and Response {#sample-request-and-response}

For a sample request and response of this API, see [Put the Default Subscription Level Configuration](https://developer.mastercard.com/riskrecon-api/documentation/testing/portfolio-samples/set-subs-lvl-config-smpl/index.md).

## Use Case Example {#use-case-example}

The use case [Set the subscription-level configuration to add new vendors](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/set-deflt-subsn-lev-config/index.md#set-the-subscription-level-configuration-to-add-new-vendors) discusses how you can use the `PUT Subscription Level Config` endpoint to update the default subscription level configuration of TOEs.

### Set the subscription-level configuration to add new vendors {#set-the-subscription-level-configuration-to-add-new-vendors}

A customer wants to onboard 14 new vendors and wants to add the TOEs in bulk to their portfolio. Since the customer wants the TOEs added using the RiskRecon Discover licenses, the customer can request to set the default subscription-level to 1 using the `PUT Subscription Level Config` endpoint. With the subscription-level set, the user can then use the `POST Bulk Add` endpoint to request multiple new TOEs to be added to their portfolio without specifying the subscription-level in the bulk add request, since the default subscription-level of RiskRecon Discover will apply to all new bulk add requests by default.

## Endpoint {#endpoint}


API Reference: `PUT /v1/portfolio/subscription_level_config`