Skip to content

Updates the display title and poster thumbnail stored on an uploaded audio media item.

Sending an empty posterSrc clears the custom poster and returns the player to its default no-thumbnail layout. Media that is not FluentPlayer audio is rejected with a 422.

Endpoint

  • Method: POST

  • Path: /fluent-player/audio-media/{media_id}

  • Edition: Core

  • Controller: MediaController@updateAudioMeta

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

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

  • The route only requires a signed-in user; ownership is enforced in the controller, so only the uploader, a community moderator or a community admin may edit.

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 Post Update Audio Meta

POST
/fluent-player/audio-media/{media_id}

Updates the display title and poster thumbnail stored on an uploaded audio media item.

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

Authorizations

ApplicationPasswords

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

Type
API Key (header: Authorization)

Parameters

Path Parameters

media_id*

Media ID extracted from the URL path.

Type
string
Required

Request Body

application/json
JSON
{
  
"title": "string",
  
"posterSrc": "string"
}

Responses

Successful response

application/json
JSON
{
  
"media": {
  
  
"media_id": "string",
  
  
"settings": {
  
  
  
"src": "string",
  
  
  
"title": "string",
  
  
  
"viewType": "string",
  
  
  
"posterSrc": "string",
  
  
  
"poster_is_custom": true
  
  
}
  
}
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation