---
title: "Delete Harbor"
method: DELETE
path: "/api/harbors/{harbor_id}"
tags: ["Harbors"]
---

# Delete Harbor

`DELETE /api/harbors/{harbor_id}`

Deletes a Harbor and revokes its credentials.

> 🚧 Harbor deletion
>
> Deleting a Harbor revokes its credentials, context documents, and user assignments. A customer-managed backing Connection remains available. Polytomic deletes a managed backing Connection only when no other resource uses it.

## Path parameters

- `harbor_id` string, uuid, required — Unique identifier of the Harbor.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- DeletedHarborEnvelope
  - `data` DeletedHarborResponse
    - `id` string, uuid — Unique identifier of the deleted Harbor.

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

## Changes

> 12 revisions in range; 2 could not be searched.

- **2026-08-13** `00c653316d35` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbors/:harbor_id/delete.md)

---

[API](https://skmtc.dev/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.dev/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/revisions/6c3b7c51e463/schema)