Skip to main content

Webhooks

The Streamdiver API facilites the efficient retrieval of events associated with API resources like e.g. Media assets via webhooks. Webhooks are automated callback messages sent from one application to another in response to specific events, e.g. when a Media asset is updated or deleted.

Webhook events overview:

  • ping - sent to validate the connection to configured URL after a webhook create or update. This event can also be triggered manually using the ping action
  • media.created - sent when a new Media is added to the system. This is typically triggered after an upload is completed, but also when eg. file is imported
  • media.updated - triggered when a Media is updated. The payload includes the updated Media representation and an array of the properties that were modified.
  • media.deleted - sent on Media deletion. Includes information whether delete operation was permanent
  • media.restored - sent when a previously deleted Media is recovered.