Skip to main content

​
Overview

Platform Admin API provides system-wide configuration management including commission rates, platform settings, and administrative controls. Location: convex/admins/platformAdmin.ts

​
Create Platform Config

const configId = await convex.mutation(api.admins.platformAdmin.createInitialPlatformConfig, {
  adminUserId: "admin_123"
});

​
Get Platform Config

const config = await convex.query(api.admins.platformAdmin.getActivePlatformConfig);

​
Update Platform Config

​
adminUserId
string
required
Admin user ID
​
configId
Id<'platformConfig'>
required
Configuration ID
​
defaultCommissionRate
number
Default commission rate
await convex.mutation(api.admins.platformAdmin.updatePlatformConfig, {
  adminUserId: "admin_123",
  configId: "pc123456789",
  defaultCommissionRate: 0.05,
  minimumCommission: 0.50,
  fixedFeePerOrder: 1.00
});
Platform configuration changes affect commission calculations system-wide.