Skip to content
SupaCloud Docs
Select themeSelect language

`PUT /api/admin/marketplace/fee-settings` — update the platform fee settings.

PUT
/api/admin/marketplace/fee-settings
curl --request PUT \
  --url https://example.com/api/admin/marketplace/fee-settings \
  --header 'Content-Type: application/json' \
  --data '{ "currency": "example", "kind_fee_overrides": "example", "min_payout_cents": 1, "package_fee_percent": 1, "runner_fee_percent": 1 }'

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
currency
string | null
kind_fee_overrides

ADR 0034 P4 — per-kind platform fee overrides ({kind: percent}). Absent kinds fall back to package_fee_percent.

min_payout_cents
required
integer format: int32
package_fee_percent
required
number format: double
runner_fee_percent
required
number format: double
Examplegenerated
{
  "currency": "example",
  "kind_fee_overrides": "example",
  "min_payout_cents": 1,
  "package_fee_percent": 1,
  "runner_fee_percent": 1
}

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

Singleton platform fee configuration (id = ‘active’). Fee percentages are stored as NUMERIC(5,2) in Postgres and cast to float8 in queries so the Rust side receives f64 without requiring a decimal crate.

object
created_at
required
string format: date-time
currency
required
string
effective_from
required
string format: date-time
id
required
string
kind_fee_overrides
required

ADR 0034 P4 — per-kind platform fee overrides ({kind: percent}); a kind absent here falls back to package_fee_percent.

min_payout_cents
required
integer format: int32
package_fee_percent
required
number format: double
runner_fee_percent
required
number format: double
updated_at
required
string format: date-time
updated_by
string | null format: uuid
Examplegenerated
{
  "created_at": "2026-04-15T12:00:00Z",
  "currency": "example",
  "effective_from": "2026-04-15T12:00:00Z",
  "id": "example",
  "kind_fee_overrides": "example",
  "min_payout_cents": 1,
  "package_fee_percent": 1,
  "runner_fee_percent": 1,
  "updated_at": "2026-04-15T12:00:00Z",
  "updated_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}