Skip to content

Uploads a video or audio file for FluentPlayer playback and returns the media record with the settings the player needs.

Send media_kind as video or audio; audio uploads additionally require the enable_audio player setting. The size limit is 300 MB by default and adjustable by filter, and the accepted MIME types come from the FluentPlayer settings.

Endpoint

  • Method: POST

  • Path: /fluent-player/video-upload

  • Edition: Core

  • Controller: MediaController@uploadVideo

  • Route source: fluent-community/Modules/Integrations/FluentPlayer/Http/player_api.php:13

  • Controller source: fluent-community/Modules/Integrations/FluentPlayer/Http/Controllers/MediaController.php

  • Requires a signed-in user, the FluentPlayer plugin to be active, and the video_upload player setting to be on.

  • Who may upload is governed by the video_upload_role player setting — community admins only, admins and moderators, or everyone.

Reconstructed sample

This endpoint belongs to a module that is not active on the reference install (or needs a file upload), so the payload below was reconstructed by reading the controller rather than recorded. Field names and types follow the source; values are illustrative.

POST Upload Video

POST
/fluent-player/video-upload

Uploads a video or audio file for FluentPlayer playback and returns the media record with the settings the player needs.

Controller: MediaController@uploadVideo
Route source: fluent-community/Modules/Integrations/FluentPlayer/Http/player_api.php:13

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Request Body

multipart/form-data
object
Format"binary"

Responses

Successful response

application/json
JSON
{
  
"media": {
  
  
"media_id": 0,
  
  
"url": "string",
  
  
"media_key": "string",
  
  
"type": "string",
  
  
"settings": {
  
  
  
"src": "string",
  
  
  
"title": "string",
  
  
  
"viewType": "string"
  
  
},
  
  
"html": "string"
  
}
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI