---
title: "POST /targetgroups/{targetGroupIdentifier}/deregistertargets"
method: POST
path: "/targetgroups/{targetGroupIdentifier}/deregistertargets"
---

# POST /targetgroups/{targetGroupIdentifier}/deregistertargets

`POST /targetgroups/{targetGroupIdentifier}/deregistertargets`

Deregisters the specified targets from the specified target group.

## Path parameters

- `targetGroupIdentifier` string, required

## Request body

- object
  - `targets` Target[], required — The targets to deregister.
    - `id` string, required — The ID of the target. If the target group type is <code>INSTANCE</code>, this is an instance ID. If the target group type is <code>IP</code>, this is an IP address. If the target group type is <code>LAMBDA</code>, this is the ARN of a Lambda function. If the target group type is <code>ALB</code>, this is the ARN of an Application Load Balancer.
    - `port` integer — The port on which the target is listening. For HTTP, the default is 80. For HTTPS, the default is 443.

## Response `200`

Success

- DeregisterTargetsResponse
  - `successful` Target[] — The targets that were successfully deregistered.
    - `id` string, required — The ID of the target. If the target group type is <code>INSTANCE</code>, this is an instance ID. If the target group type is <code>IP</code>, this is an IP address. If the target group type is <code>LAMBDA</code>, this is the ARN of a Lambda function. If the target group type is <code>ALB</code>, this is the ARN of an Application Load Balancer.
    - `port` integer — The port on which the target is listening. For HTTP, the default is 80. For HTTPS, the default is 443.
  - `unsuccessful` TargetFailure[] — The targets that the operation couldn't deregister.
    - `id` string — The ID of the target. If the target group type is <code>INSTANCE</code>, this is an instance ID. If the target group type is <code>IP</code>, this is an IP address. If the target group type is <code>LAMBDA</code>, this is the ARN of a Lambda function. If the target group type is <code>ALB</code>, this is the ARN of an Application Load Balancer.
    - `port` integer — The port on which the target is listening. This parameter doesn't apply if the target is a Lambda function.
    - `failureCode` string — The failure code.
    - `failureMessage` string — The failure message.

## Other responses

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

---

[API](https://skmtc.net/aws/apis/vpc-lattice.md) · [All operations](https://skmtc.net/aws/apis/vpc-lattice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/vpc-lattice/versions/bbec5439e0f7/schema)