---
title: "Send Held Notice"
method: POST
path: "/api/v1/admin/held-requests/{held_id}/notice"
---

# Send Held Notice

`POST /api/v1/admin/held-requests/{held_id}/notice`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/admin/held-requests/{held_id}/notice`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

"Invia l'avviso": tell the operator a request is waiting. For a
business the team has reached by phone and whose company mailbox is on
file. Without a recorded call it is refused, unless the admin writes why
it goes anyway, which is audited. One notice per held request.

## Path parameters

- `held_id` string, uuid, required

## Request body

- HeldNoticeRequest: Send the notice for a held request. `override_note` is why it goes to a business nobody has reached by phone: without a recorded call it is required, and it is kept in the audit trail.
  - `override_note` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)
