---
title: "Remove Subdomain"
method: DELETE
path: "/domains/{domain_id}/subdomains/{subdomain_id}"
---

# Remove Subdomain

`DELETE /domains/{domain_id}/subdomains/{subdomain_id}`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/domains/{domain_id}/subdomains/{subdomain_id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `domains:write`

Removes a subdomain from a attack surface domain

## Path parameters

- `domain_id` integer, required
- `subdomain_id` string, uuid, required

## Response `200`

The subdomain has been removed successfully

- object
  - `success` integer: The integer 1 indicating success

## Other responses

- `400`: Subdomain could not be removed

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)