---
title: "This endpoint allows a user to update the internal_ids and/or internal_name of an existing `TOE` by its identifier."
method: PUT
path: "/v1/toe/{toe_id}"
tags: ["Target Of Evaluation TOE"]
---

# This endpoint allows a user to update the internal_ids and/or internal_name of an existing \`TOE\` by its identifier.

`PUT /v1/toe/{toe_id}`

## Request

- Base URL: `https://api.sandbox.riskrecon.com`
- URL: `https://api.sandbox.riskrecon.com/v1/toe/{toe_id}`
- Auth: HTTP bearer

This endpoint allows a user to update the internal_ids and/or internal_name of an existing `TOE` by its identifier.
These can be used to map a TOE in the RiskRecon system to an entity in the users system.

## Path parameters

- `toe_id` string, required

## Request body

- TOEUpdate: This is for updating the internal_id and/or internal_name of a TOE in a portfolio.
  - `internal_name` string[], nullable: The user defined names for the TOE.
  - `internal_id` string[], nullable: The user defined identifiers for the TOE. These can be used to query the TOE.

## Response `200`

OK

- TOEUpdated: The response for updating values for a given TOE. Only internal_id and internal_name are allowed to be updated by a user.
  - `toe_short_name` string: The Company or entity name.
  - `toe_id` string, uuid: The unique identifier for the Target Of Evaluation (TOE).
  - `internal_name` string[], nullable: The user defined names for the TOE.
  - `internal_id` string[], nullable: The user defined identifiers for the TOE. These can be used to query the TOE.

## Other responses

- `400`: Something was wrong with the request
- `401`: Authentication information was missing or invalid or the user is not authorized to access resource or perform the associated action.
- `404`: The URI didn't match an existing resource.

---

[API](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/mastercard-riskrecon-api/revisions/212ef0eeee9b?raw)