---
title: "Delete subdomain"
method: DELETE
path: "/v1/teams/{teamId}/domains/{domain}/subdomains/{subdomain}"
tags: ["Domains", "team"]
---

# Delete subdomain

`DELETE /v1/teams/{teamId}/domains/{domain}/subdomains/{subdomain}`

## Request

- Base URL: `https://placeholder/v1`
- URL: `https://placeholder/v1/v1/teams/{teamId}/domains/{domain}/subdomains/{subdomain}`
- Auth: none required
- TypeScript: <https://skmtc.dev/northflank/apis/northflank-api/docs/v1/teams/:teamId/domains/:domain/subdomains/:subdomain/delete.ts> (a function with typed inputs; its response is checked against the schema)

Removes a subdomain from a domain.

## Path parameters

- `teamId` string, required
- `domain` string, required: Name of the domain
- `subdomain` string, required: Name of the subdomain

## Response `200`

The operation was performed successfully.

## Other responses

- `400`: The default (empty) subdomain cannot be deleted.
- `404`: The subdomain does not exist.

## Changes

- **2026-11-06** `503a425aa44f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/northflank/apis/northflank-api/changes/v1/teams/:teamId/domains/:domain/subdomains/:subdomain/delete.md)

---

[API](https://skmtc.dev/northflank/apis/northflank-api.md) - [All operations](https://skmtc.dev/northflank/apis/northflank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/northflank/apis/northflank-api/revisions/6511db980148?raw)