---
title: "Release a reservation."
method: DELETE
path: "/api/ports/reservations/{id}"
tags: ["ports"]
---

# Release a reservation.

`DELETE /api/ports/reservations/{id}`

## Request

- The document declares no server URL.
- Auth: none declared

Gives the ports back. Ports the owner has declared in use by a flow that still exists stay held until that flow is gone — a port returns to the pool only when no live reservation and no existing flow holds it.

## Path parameters

- `id` string, uuid, required

## Response `204`

Reservation released

## Other responses

- `404`: No live reservation with that id
- `500`: Reservation could not be persisted
- `503`: No port pool is configured on this server

## Changes

- **2026-09-28** `fd671a19e55a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/eyevinn/apis/strom-api/changes/api/ports/reservations/:id/delete.md)

---

[API](https://skmtc.dev/eyevinn/apis/strom-api.md) - [All operations](https://skmtc.dev/eyevinn/apis/strom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eyevinn/apis/strom-api/revisions/8cd4dbc44175?raw)
