# Delete a TOE from your Portfolio
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/delete-a-toe/index.md

## Overview {#overview}

The `DELETE a TOE` endpoint deletes a TOE from your portfolio. You must provide the `toe_id` as the API request parameter to delete a TOE from your portfolio.

You must have the [Add Company](https://developer.mastercard.com/riskrecon-api/documentation/glossary/index.md#addcompany-scope) scope to be able to delete TOEs from your portfolio.

A customer can delete only 10 TOEs per day. For example, an organization has two departments, namely, the Vendor Management department and the Risk Management department. If a user from the Vendor Management department has deleted 5 TOEs and another user from the Risk Management department raises a request to delete 6 TOEs, then the last TOE will not be deleted as only 10 TOEs can be deleted on any particular day.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to delete a TOE from your portfolio:
Diagram delete-a-toe

## Execution Steps {#execution-steps}

The following steps describe how to delete a TOE from your portfolio:

1. The user sends a `DELETE` request to delete a TOE from the portfolio and provides the `toe_id` as the input parameter.
2. RiskRecon deletes the requested TOE from the user's portfolio.

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

For a sample response for this API, see [Delete a TOE from your Portfolio](https://developer.mastercard.com/riskrecon-api/documentation/testing/toe-samples/delete-a-toe-smpl/index.md).

## Use Case Examples {#use-case-examples}

The use cases in this section discuss how you can use the `DELETE a TOE` endpoint to delete TOEs from your portfolio:

* [Delete vendor with whom business relationship has ended](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/delete-a-toe/index.md#delete-a-vendor-with-whom-business-relationship-has-ended)
* [Delete vendors with poor rating](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/delete-a-toe/index.md#delete-vendors-with-poor-rating)

### Delete a vendor with whom business relationship has ended {#delete-a-vendor-with-whom-business-relationship-has-ended}

An organization has decided to discontinue the services of a vendor. The user can use the `DELETE a TOE` endpoint to delete the vendor from its portfolio.

### Delete vendors with poor rating {#delete-vendors-with-poor-rating}

A customer is evaluating new vendors to expand their supply chain and have added them to their portfolio for further analysis. The customer finds that the cybersecurity environment of some of the vendors is unhealthy and has a 'F' rating. Because of the poor rating, they have decided not to do business with the vendor and hence uses this endpoint to delete the TOEs.

## Endpoint {#endpoint}


API Reference: `DELETE /v1/toe/{toe_id}`