---
title: "A suggestion, as its form"
method: GET
path: "/{region}/videos/editable"
tags: ["Tanks"]
---

# A suggestion, as its form

`GET /{region}/videos/editable`

## Request

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

One suggested battle in the shape the form that corrects it needs: the link rather than the video id, the team number rather than the direction derived from it, the tank and clan as the slug and tag the form searches by. Readable by its author, and by a moderator holding the signed link the moderation channel hands out. A row the caller may not edit is answered 403 rather than shown, since an unreviewed suggestion is visible to the person waiting on it and to nobody else. 401 when signed out and no token is given.

## Path parameters

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

## Query parameters

- `id` integer, required: The suggestion to read back.
- `token` string: Signed moderator link, from the moderation channel.

## Response `200`

Successful response

- VideoEditableResponse
  - `id` integer, required
  - `status` 'pending' | 'approved' | 'rejected', required: Where a suggested video stands in moderation.
  - `title` string, required
  - `url` string, required: YouTube link, rebuilt with the stored start time.
  - `startSeconds` integer, required
  - `arenaId` string, nullable, required
  - `mode` 'standard' | 'encounter' | 'assault' | 'attack-defense', required: Random-battle game mode a map supports.
  - `spawnTeam` integer, nullable, 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, nullable, required
  - `tankName` string, nullable, required
  - `combinedDamage` integer, nullable, required
  - `teamSize` integer, nullable, required
  - `tier` integer, nullable, required
  - `clan` VideoClanCredit, nullable, required: Clan the battle was played for, resolved from a stored id so a rename cannot strand the credit.
    - `region` 'eu' | 'na' | 'asia', required: Game server region.
    - `id` integer, required
    - `tag` string, required
    - `name` string, required
    - `color` string, nullable, required: The clan's own colour, which its tag is rendered in.
    - `emblem` string, nullable, required: The clan's emblem, drawn beside its tag.
  - `reviewNote` string, nullable, required: Why it was turned down, when it was.

---

[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)