GET	/api/settings/storage
PUT	/api/settings/storage
DELETE	/api/settings/storage
POST	/api/settings/storage/test

Read storage config

GET/api/settings/storage

Effective config, secret masked.

Authentication: bearer token.
Permission: settings.storage.

curl -X GET "https://shellius.example.com/api/settings/storage" \
  -H "Authorization: Bearer $SHELLIUS_TOKEN"

200 OK

{ "success": true, "data": { … } }

Upsert storage config

PUT/api/settings/storage

Upsert + encrypt secret.

Authentication: bearer token.
Permission: settings.storage.

Request body

Name	Type	Required	Notes
provider	string	Yes	One of minio, s3, azure.
endpoint	string	No	At most 500 characters. May be null.
region	string	No	At most 100 characters. May be null.
bucket	string	No	At most 255 characters. May be null.
accessKey	string	No	At most 500 characters. May be null.
secretKey	string	No	At most 2000 characters. May be null.
useSsl	boolean	No
forcePathStyle	boolean	No
isActive	boolean	No

curl -X PUT "https://shellius.example.com/api/settings/storage" \
  -H "Authorization: Bearer $SHELLIUS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "minio"
  }'

200 OK

{ "success": true, "data": { … } }

Revert storage to env

DELETE/api/settings/storage

Revert to env defaults.

Authentication: bearer token.
Permission: settings.storage.

curl -X DELETE "https://shellius.example.com/api/settings/storage" \
  -H "Authorization: Bearer $SHELLIUS_TOKEN"

200 OK

{ "success": true, "data": { … } }

Test storage

POST/api/settings/storage/test

Verify connectivity + bucket.

Authentication: bearer token.
Permission: settings.storage.

curl -X POST "https://shellius.example.com/api/settings/storage/test" \
  -H "Authorization: Bearer $SHELLIUS_TOKEN"

Returns a file or plain text, not the JSON envelope.