---
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}`

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.net/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.net/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)