---
title: "One saved remix"
method: GET
path: "/v1/remixes/{remix_id}"
tags: ["hooks"]
---

# One saved remix

`GET /v1/remixes/{remix_id}`

## Request

- Base URL: `https://api.hookdetector.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hookdetector.com/v1/remixes/{remix_id}`
- Auth: none declared

One remix you paid for (a hook's or a find's), as its answer held it. Free. 404
remix_not_found for one that is not yours. MCP: get_remix.

## Path parameters

- `remix_id` string, uuid, required

## Headers

- `authorization` string, nullable: Bearer hd_... from POST /v1/accounts or POST /v1/keys

## Response `200`

Successful Response

- SavedRemixOut: A paid remix read back (audit F16): what the answer that paid for it held, without the balance.
  - `remix_id` string, required
  - `hook_id` string, nullable: the hook it was written from, or null
  - `find_id` string, nullable: the find it was written from, or null
  - `kind` string, nullable: long or packaging, for a find's remix
  - `mode` string, nullable: "intro" for a Write my intro remix; absent otherwise
  - `video_brief` string, nullable: a Write my intro remix: the description of the video it was written for
  - `niche` string, nullable, required: the niche asked for; null for a Write my intro remix
  - `n` integer, required
  - `written` object[], required: as the paid answer held it: lines from a hook, openings or packages from a find, or one intro object (mode intro)
  - `label` string, required: written by Hook Detector, never found: show it with them
  - `credits_charged` integer, required
  - `created_at` string, required

## Other responses

- `401`: missing, invalid, revoked or expired API key (code key_expired)
- `403`: the key lacks the scope this call needs (insufficient_scope), or its credit_limit is spent (key_credit_limit_reached)
- `404`: not found on this account
- `413`: request body over the size cap
- `422`: invalid input
- `500`: our fault; names the request id

---

[API](https://skmtc.dev/hookdetector/apis/hook-detector.md) · [All operations](https://skmtc.dev/hookdetector/apis/hook-detector/llms.txt) · [OpenAPI document](https://skmtc.dev/hookdetector/apis/hook-detector/revisions/b136a2804d2b?raw)