---
title: "Unassign IPs from Subaccount"
method: POST
path: "/ip/unassign"
tags: ["IP Management API"]
---

# Unassign IPs from Subaccount

`POST /ip/unassign`

This allows a parent account to remove one or more dedicated IP addresses that were previously assigned to a subaccount. Each request specifies the subaccount, sending domain, and the IPs to be unassigned.

## Request body

- object
  - `removals` object[], required — A list of removal objects specifying the IPs to unassign from subaccounts. Minimum 1 and maximum 10 removal objects per request.
    - `ip_address` string[], required — One or more IP addresses to remove from the subaccount. Must be valid dedicated IPs that are already assigned to the target subaccount. Atleast 1 IP, maximum 100 IPs per removal object.
    - `account_name` string, required — The username of the subaccount from which the IPs should be unassigned. The subaccount must exist under the parent account.
    - `sending_domain` string, hostname, required — The sending domain currently linked with the IP assignment. Must be valid and associated with the subaccount.

## Response `200`

IPs unassigned successfully

- object
  - `status` 'success' | 'partial_success' | 'error'
  - `message` string
  - `results` object[]
    - `account_name` string
    - `ip` string
    - `sending_domain` string
    - `status` 'success' | 'error'
    - `message` string

## Other responses

- `400` — Validation error
- `401` — Authentication required
- `403` — Access forbidden or IP not assigned

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)