---
title: "Recover missing video recommendations"
method: POST
path: "/api/v1/checks/{check_id}/videos/recover"
tags: ["checks"]
---

# Recover missing video recommendations

`POST /api/v1/checks/{check_id}/videos/recover`

## Request

- Base URL: `https://api.trueight.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.trueight.com/api/v1/checks/{check_id}/videos/recover`
- Auth: none declared

Owner-only, idempotent on-demand recovery for videos that the
fire-and-forget generation task lost (e.g. an API restart during its short
window). Returns existing videos untouched if any exist; otherwise
generates them durably (awaited, in-request, so it survives) for a
completed check and returns them.

## Path parameters

- `check_id` string, required

## Response `200`

Video recommendations

- VideosResponse: Video recommendations for a check or claim.
  - `checkId` string, required: Check ID
  - `videos` VideoItem[], required: Video recommendations
    - `id` string, required: Database ID
    - `claimId` string, required: Parent claim ID
    - `videoId` string, required: YouTube video ID
    - `title` string, required: Video title
    - `description` string, nullable: Video description excerpt
    - `channelName` string, nullable: YouTube channel name
    - `channelId` string, nullable: YouTube channel ID
    - `publishDate` string, nullable: Video publish date (ISO 8601)
    - `videoUrl` string, required: Full YouTube watch URL
    - `thumbnailUrl` string, nullable: Video thumbnail URL
    - `duration` string, nullable: Video duration in ISO 8601 format
    - `tierLabel` 'primary' | 'reporting' | 'commentary': Source tier classification — structural role of the source.
    - `typeLabel` 'data' | 'official' | 'news' | 'analysis' | 'opinion' | 'academic': Source type classification — content category.

## Other responses

- `403`: Not authorised
- `404`: Check not found
- `422`: Validation Error

---

[API](https://skmtc.dev/trueight/apis/tru8-evidence-research-api.md) · [All operations](https://skmtc.dev/trueight/apis/tru8-evidence-research-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trueight/apis/tru8-evidence-research-api/revisions/5684065fa01a?raw)