JMV Public API

Generates a JWT token using only the plan UUID (resource). Official endpoint — no user credentials required.

Body

Request

CopyPOST /v2/authenticate
Content-Type: application/json

{
  "resource": "eeba7244-e850-4064-aa61-008718b6e4b0"
}

Response — 200 OK

Copy{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Returns the paginated list of videos in the plan, with filtering and sorting options.

Query Parameters

Returns a single video formatted with the plan secret for generating signed URLs.

Path Parameters

Deletes a video from the plan. Deletion is processed asynchronously — the video becomes unavailable immediately, but physically removing the file may take a few moments to complete.

Moves a video to a different gallery.

Body

Updates a video's display name.

Body

Uploads a thumbnail via multipart/form-data. Limited to 1 MB. The image is sent to the Static API and the video's thumb field is updated.

Returns the list of videos with conversion jobs in progress for the specified plan.

Returns the normalized status of a video's conversion job.

Return values

Returns the plan's gallery tree, including child galleries (children).

Copy{
  "folders": [
    {
      "id":          1,
      "uuid":        "a1b2c3d4-...",
      "name":        "Training",
      "description": "Internal training videos",
      "children": []
    }
  ]
}

Body

Updates the name and/or description of an existing gallery.

Deletes a gallery. Galleries with associated videos cannot be deleted.

Creates a new event with the initial status WAITING_LIVE.

Body

Returns a paginated list of the plan's events.

Changes the status of a live event. The lifecycle follows the sequence:

CopyWAITING_LIVE  →  LIVE  →  ON_DEMAND

Deletes one or more events. Accepts an array of IDs in the body.

Body

Copy{
  "ids": [42, 43, 44]
}

Returns all videos in a plan's playlist in the configured order.

Body

Changes the position of a video in the playlist.

Body

Removes a video from the playlist without deleting it from the system.

Returns the video currently playing in the player. Queries the Webtv database (real-time read).

Creates a new stream target on the Stream Gateway.

Body

Returns the current broadcast status directly from the Stream Gateway.

Body

Removes the broadcast from the Stream Gateway. This operation is irreversible.

Creates a multipart upload in MinIO and returns all presigned URLs at once. Each URL is valid for 6 hours.

Body

Request

CopyPOST /v2/upload/multipart/s3
Authorization: Bearer <token>
Content-Type: application/json

{
  "fileName":   "training-video.mp4",
  "fileSize":   1073741824,
  "totalParts": 16,
  "chunkSize":  67108864
}

Response — 200 OK

Copy{
  "uploadId":    "minio-upload-id-xyz",
  "objectName":  "uploads/vod123/a8f3k2m9x1q4p.mp4",
  "video_hash":  "a8f3k2m9x1q4p",
  "totalParts":  16,
  "presignedUrls": [
    { "partNumber": 1, "url": "https://minio.../upload?partNumber=1&uploadId=..." },
    { "partNumber": 2, "url": "https://minio.../upload?partNumber=2&uploadId=..." }
  ]
}

Sending the parts (client-side)

For each presigned URL, make a PUT directly to MinIO with the corresponding chunk:

Copy// JavaScript — send each part
const uploadedParts = [];

for (let i = 0; i < presignedUrls.length; i++) {
  const { partNumber, url } = presignedUrls[i];
  const start = i * chunkSize;
  const chunk = file.slice(start, start + chunkSize);

  const res = await fetch(url, {
    method: 'PUT',
    body: chunk,
    headers: { 'Content-Type': 'application/octet-stream' }
  });

  uploadedParts.push({
    partNumber,
    etag: res.headers.get('ETag')
  });
}

Completes the multipart upload in MinIO, registers the video in the database and queues the processing job on the s3-upload-queue queue.

Body

Request

Copy{
  "filename":   "training-video.mp4",
  "size":       1073741824,
  "video_hash": "a8f3k2m9x1q4p",
  "objectName": "uploads/vod123/a8f3k2m9x1q4p.mp4",
  "uploadId":   "minio-upload-id-xyz",
  "gallery":   "a1b2c3d4-e5f6-...",
  "parts": [
    { "partNumber": 1, "etag": "\"abc123\"" },
    { "partNumber": 2, "etag": "\"def456\"" }
  ]
}

Generates a presigned URL to upload a file in a single PUT request. Valid for 24 hours. Recommended for files smaller than 100 MB.

Body

Confirms that the file was uploaded to MinIO via PUT, validates that the object exists (headObject), registers the video and queues the processing job.

Body