Skip to content

Validates and stores the media storage driver configuration, testing the connection before saving anything for remote drivers.

Required fields differ per driver (amazon_s3, bunny_cdn, cloudflare_r2 and local). Sending the literal FCOM_ENCRYPTED_DATA_KEY for access_key or secret_key keeps the currently stored credential instead of overwriting it. A failed connection test aborts the save. Selecting local also switches the cloud_storage feature flag off; any remote driver switches it on.

Endpoint

  • Method: POST

  • Path: /admin/storage-settings

  • Edition: Core

  • Controller: AdminController@updateStorageSettings

  • Route source: fluent-community/app/Http/Routes/api.php:107

  • Controller source: fluent-community/app/Http/Controllers/AdminController.php

  • Requires the FluentCommunity community-admin permission (or a WordPress super admin).

  • Requires FluentCommunity Pro; rejected outright when the FLUENT_COMMUNITY_CLOUD_STORAGE constant defines the config in code.

Live sample

The request and response below were recorded against a running FluentCommunity install and then anonymised — member names, emails, avatars and post content are fictional, and long collections are trimmed to a few entries.

POST Save Storage Settings

POST
/admin/storage-settings

Validates and stores the media storage driver configuration, testing the connection before saving anything for remote drivers.

Controller: AdminController@updateStorageSettings
Route source: fluent-community/app/Http/Routes/api.php:107

Authorizations

ApplicationPasswords

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

Type
API Key (header: Authorization)

Request Body

application/json
JSON
{
  
"config": {
  
  
"driver": "string"
  
}
}

Responses

Successful response

application/json
JSON
{
  
"message": "string"
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation