---
title: "Internal Refine Overlay"
method: POST
path: "/internal/refine-overlay"
---

# Internal Refine Overlay

`POST /internal/refine-overlay`

## Request

- Base URL: `https://sleipnir.tv` (the document declares no server; this is the origin it was published from)
- URL: `https://sleipnir.tv/internal/refine-overlay`
- Auth: none declared

MCP backend for the refine_overlay tool (PAT clients only; Odin does not
get refine). Same shared callable as the web route; ownership on the
overlay_id is enforced inside _do_refine_overlay.

## Headers

- `X-Sleipnir-Hook-Auth` string, nullable

## Request body

- InternalRefineOverlayPayload
  - `token` string, nullable
  - `overlay_id` string, nullable
  - `note` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sleipnir/apis/relay-control-plane.md) · [All operations](https://skmtc.dev/sleipnir/apis/relay-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/sleipnir/apis/relay-control-plane/revisions/79829f6945a4?raw)