---
title: "Updates the status of a subdomain."
method: PATCH
path: "/api/v2/companies/{id}/subdomains"
tags: ["Company Digital Footprint"]
---

# Updates the status of a subdomain.

`PATCH /api/v2/companies/{id}/subdomains`

Update the status of a subdomain.

## Path parameters

- `id` integer, required

## Request body

- object
  - `Subdomain` string — The subdomain to be updated.
  - `Status` 'Active' | 'Inactive', nullable, required — The new status of the subdomain. Inactive subdomains are excluded from the scans and from the risk score calculations.

## Response `200`

Success

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/revisions/7dadaba760fb/schema)