---
title: "Add media to the VTC gallery"
method: POST
path: "/vtcs/{id}/management/gallery"
tags: ["VTC Management"]
---

# Add media to the VTC gallery

`POST /vtcs/{id}/management/gallery`

## Request

- Base URL: `https://api.trucklinemp.com`
- URL: `https://api.trucklinemp.com/vtcs/{id}/management/gallery`
- Auth: HTTP bearer

Adds an image or video by link. Images must be hosted on a supported image host (Imgur, ImgBB, …) with an image file extension; YouTube and Vimeo links become video embeds. Discord attachment links are rejected because they expire. Limited to 60 items per hour per VTC and 1,000 items in total. Needs the write scope `gallery.upload`.

## Path parameters

- `id` string, required: VTC id or handle.

## Request body

- object
  - `title` string, required
  - `url` string, required: Image link from a supported host (Imgur, ImgBB, …), or a YouTube or Vimeo video.
  - `caption` string, nullable
  - `altText` string, nullable
  - `albumId` integer, nullable

## Response `200`

OK

- object
  - `id` number, required
  - `albumId` number, nullable, required
  - `mediaType` string, required
  - `provider` string, required
  - `url` string, required
  - `thumbnailUrl` string, nullable, required

## Changes

- **2026-10-11** `f480df65298f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/changes/vtcs/:id/management/gallery/post.md)

---

[API](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api.md) - [All operations](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/revisions/98fe7178ea0e?raw)
