Update Platform Settings

PATCH

https://stageapi.partake.ng/api/v2/admin/settings

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Updates one or more platform settings (patch semantics). Cache is busted immediately. At least one gateway must remain enabled. Admin only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟠400

application/json

Bodyapplication/json

🟢200

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://stageapi.partake.ng/api/v2/admin/settings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "platformCommissionRate": 10, // optional — 0–100 (percent)
    "defaultContestDurationDays": 30, // optional — min 1
    "maxFreeVotesPerIpPerDay": 5, // optional — min 1
    "merchantApprovalMode": "manual", // optional — auto | manual
    "contestApprovalRequired": false, // optional
    "paymentGatewaysEnabled": [
        "paystack"
    ], // optional — must have at least one
    "storageProvider": "cloudinary", // optional - s3 or cloudinary
    "emailProvider": "mailgun", //resend mailgun
    "otpLength": 6, // optional
    "otpTtlSeconds": 300,// optional
    "otpMaxAttempts": 5,// optional
    "otpResendCooldownSeconds": 60,// optional
    "smsProvider": "termii",// optional
    "uploadMaxSizeProfile": 2097152,    // optional
    "uploadMaxSizeBanner": 5242880, // optional
    "uploadMaxSizeEntry": 10485760, // optional
    "uploadPendingTtlHours": 24,    // optional
    "schedulerEnabled": false,   // optional
    "staleDraftThresholdDays": 90,  // optional
    "schedulerBatchSize": 100,  // optional
    "schedulerFailureThreshold": 5  // optional
}'

Response Example

400 - 400 Bad Request

{
    "success": false,
    "error": {
        "code": "AT_LEAST_ONE_GATEWAY_REQUIRED",
        "message": "At least one payment gateway must remain enabled.",
        "details": {}
    },
    "statusCode": 400
}

Modified at 2026-07-10 13:15:30

Get Platform Settings

List Available Permissions