---
title: "Notify Video Status"
method: POST
path: "/api/v1/videos/{video_uuid}/notify"
tags: ["Videos"]
---

# Notify Video Status

`POST /api/v1/videos/{video_uuid}/notify`

Trigger webhooks for video processing completion or failure.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response without triggering webhooks.

## Path parameters

- `video_uuid` string, required

## Headers

- `x-api-key` string, nullable
- `League` string, nullable

## Request body

- VideoNotifyRequest — Request schema for triggering video completion webhooks.
  - `status` 'completed' | 'failed', required — Video processing status
  - `message` string, nullable — Additional message (e.g., error details for failed status)

## Response `200`

Successful Response

- VideoNotifyResponse — Response schema for video notify endpoint.
  - `success` boolean, required — Whether the operation was successful
  - `message` string, required — Status message
  - `webhooks_triggered` integer, required — Number of webhook deliveries initiated

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.net/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/versions/42cb7b14430f/schema)