---
title: "Suggest a video"
method: POST
path: "/{region}/videos/suggest"
tags: ["Tanks"]
---

# Suggest a video

`POST /{region}/videos/suggest`

## Request

- Base URL: `https://unicum.gg/api`
- URL: `https://unicum.gg/api/{region}/videos/suggest`
- Auth: none required

Queue a YouTube link for moderation. Requires a signed-in Wargaming account, so a suggestion always carries who made it. The link must be a YouTube video we can embed, and its timestamp is what marks the battle. A submission is filed under the map it was fought on, which is checked against the catalogue along with the mode, so a battle cannot be filed under a map that never runs it. A random battle also names the vehicle and the damage; a competitive battle names neither, since a tactic belongs to the ground and the side rather than to one player's game. Nothing is published here: a moderator approves it first. 401 when signed out, 404 when submissions are unconfigured, 409 when that exact battle was already submitted.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.

## Request body

- VideoSuggestBody
  - `url` string, required: YouTube link, timestamp included.
  - `startSeconds` integer
  - `arenaId` string, required
  - `mode` 'standard' | 'encounter' | 'assault' | 'attack-defense', required: Random-battle game mode a map supports.
  - `spawnTeam` integer, required
  - `result` 'victory' | 'defeat' | 'draw', required: How the battle ended, as declared by the submitter.
  - `format` 'random' | 'clan_wars' | 'advances' | 'skirmish' | 'maneuvers' | 'onslaught' | 'tournament', required: Format the battle was played in.
  - `tankSlug` string: Vehicle the battle was played in, for a random battle.
  - `combinedDamage` integer: Damage dealt plus assisted, on a random battle.
  - `teamSize` integer
  - `tier` integer
  - `clanTag` string: Tag of the clan the battle was played for.

## Response `200`

Successful response

- VideoSuggestResponse
  - `ok` boolean, required
  - `discordLinked` boolean, required: Whether the caller has a Discord account linked, which is what lets the moderator's verdict reach them as a direct message. False is not an error: the suggestion is queued either way and the submitter's own queue on the site shows its status.

---

[API](https://skmtc.dev/unicum/apis/unicum-gg-api.md) · [All operations](https://skmtc.dev/unicum/apis/unicum-gg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unicum/apis/unicum-gg-api/revisions/7a7d79a26001?raw)