kmp_ctrl_unpublish_url

The kmp_ctrl_unpublish_url directive is part of the Kaltura Media Framework's NGINX module, which facilitates interactions between NGINX and various media processing components. This directive allows users to define the URL that the media controller will use to send HTTP requests when unpublishing a media component. An unpublish operation typically indicates that a live stream is being terminated or that certain media content should no longer be available for playback or processing. When configured, this URL will accept POST requests containing JSON data detailing the media component to be unpublished.

The directive accepts a single argument: the complete URL to the unpublish endpoint. This URL must be accessible by the NGINX server and should be properly set up to handle the incoming requests from the controller. It is essential that the endpoint implemented can correctly process these requests; otherwise, unpublishing might fail. When the unpublish action is triggered through the Kaltura Media Protocol, a request will be constructed, serialized as JSON, and sent to the defined URL. The handling of this request at the application level must properly interpret the JSON payload to execute the necessary logic for unpublishing the media component in question.