---
title: "PATCH /harnesses/{harnessId}/endpoints/{endpointName}"
method: PATCH
path: "/harnesses/{harnessId}/endpoints/{endpointName}"
---

# PATCH /harnesses/{harnessId}/endpoints/{endpointName}

`PATCH /harnesses/{harnessId}/endpoints/{endpointName}`

Operation to update a harness endpoint.

## Path parameters

- `harnessId` string, required
- `endpointName` string, required

## Request body

- object
  - `targetVersion` string — The harness version that the endpoint points to. If not specified, the existing value is retained.
  - `description` string — A description of the endpoint. If not specified, the existing value is retained.
  - `clientToken` string — A unique, case-sensitive identifier to ensure idempotency of the request.

## Response `200`

Success

- UpdateHarnessEndpointResponse
  - `endpoint` object, required — The updated endpoint.
    - `harnessId` string, required — The ID of the harness that the endpoint belongs to.
    - `harnessName` string, required — The name of the harness that the endpoint belongs to.
    - `endpointName` string, required — The name of the endpoint.
    - `arn` string, required — The ARN of the endpoint.
    - `status` 'CREATING' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'READY' | 'DELETING' | 'DELETE_FAILED', required — The status of the endpoint.
    - `createdAt` string, date-time, required — The timestamp when the endpoint was created.
    - `updatedAt` string, date-time, required — The timestamp when the endpoint was last updated.
    - `liveVersion` string — The harness version that the endpoint is currently serving.
    - `targetVersion` string — The harness version that the endpoint points to. While an update is in progress, this can differ from the live version until the endpoint finishes transitioning.
    - `description` string — The description of the endpoint.
    - `failureReason` string — The reason the endpoint's last create or update operation failed.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ValidationException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)