---
title: "DELETE /gateways/{gatewayIdentifier}/targets/{targetId}/"
method: DELETE
path: "/gateways/{gatewayIdentifier}/targets/{targetId}/"
---

# DELETE /gateways/{gatewayIdentifier}/targets/{targetId}/

`DELETE /gateways/{gatewayIdentifier}/targets/{targetId}/`

Deletes a gateway target.

You cannot delete a target that is in a pending authorization state (`CREATE_PENDING_AUTH`, `UPDATE_PENDING_AUTH`, or `SYNCHRONIZE_PENDING_AUTH`). Wait for the authorization to complete or fail before deleting the target.

## Path parameters

- `gatewayIdentifier` string, required
- `targetId` string, required

## Response `202`

Success

- DeleteGatewayTargetResponse
  - `gatewayArn` string, required — The Amazon Resource Name (ARN) of the gateway.
  - `targetId` string, required — The unique identifier of the deleted gateway target.
  - `status` 'CREATING' | 'UPDATING' | 'UPDATE_UNSUCCESSFUL' | 'DELETING' | 'READY' | 'FAILED' | 'SYNCHRONIZING' | 'SYNCHRONIZE_UNSUCCESSFUL' | 'CREATE_PENDING_AUTH' | 'UPDATE_PENDING_AUTH' | 'SYNCHRONIZE_PENDING_AUTH', required — The current status of the gateway target deletion.
  - `statusReasons` StatusReason[] — The reasons for the current status of the gateway target deletion.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — 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)