Videos

Notify Video Status

Trigger webhooks for video processing completion or failure.

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

post/api/v1/videos/{video_uuid}/notify

Path parameters

video_uuidstring required

Headers

x-api-keystring required

Required API key issued by Preciser.

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Required tenant/database selector, for example pitchbio-master.

Request body

status'completed' | 'failed' required

Video processing status

messagestring nullable

Additional message (e.g., error details for failed status)

Example request

{
  "status": "completed"
}

Response

Successful Response

successboolean required

Whether the operation was successful

messagestring required

Status message

webhooks_triggeredinteger required

Number of webhook deliveries initiated

Changes

Changed in 1 of the 10 revisions of this API.42

Aug 27, 20269b0abde08b0642See the full diff
- ▲
  the header request parameter League became required
  request-parameter-became-required
- ▲
  the header request parameter x-api-key became required
  request-parameter-became-required
- ▲
  header request parameter League list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ▲
  header request parameter x-api-key list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ○
  for the header request parameter League, the type/format was generalized from / to string/
  request-parameter-type-generalized
- ○
  for the header request parameter x-api-key, the type/format was generalized from / to string/
  request-parameter-type-generalized