---
title: "DELETE /v1/gateway-instances/{gatewayInstanceArn}"
method: DELETE
path: "/v1/gateway-instances/{gatewayInstanceArn}"
---

# DELETE /v1/gateway-instances/{gatewayInstanceArn}

`DELETE /v1/gateway-instances/{gatewayInstanceArn}`

Deregisters an instance. Before you deregister an instance, all bridges running on the instance must be stopped. If you want to deregister an instance without stopping the bridges, you must use the --force option.

## Path parameters

- `gatewayInstanceArn` string, required

## Query parameters

- `force` boolean

## Response `202`

Success

- DeregisterGatewayInstanceResponse
  - `GatewayInstanceArn` string — The Amazon Resource Name (ARN) of the instance.
  - `InstanceState` 'REGISTERING' | 'ACTIVE' | 'DEREGISTERING' | 'DEREGISTERED' | 'REGISTRATION_ERROR' | 'DEREGISTRATION_ERROR' — The status of the instance.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — ForbiddenException
- `483` — NotFoundException
- `484` — ServiceUnavailableException
- `485` — TooManyRequestsException
- `486` — ConflictException

---

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