Skip to main content
PUT
Update tenant settings

Authorizations

Authorization
string
header
required

Locus Pro dashboard session (Cognito). High-risk workspace administration requires an owner or admin role and fresh MFA/passkey step-up.

Headers

X-Locus-Step-Up
string<password>

Short-lived raw MFA/passkey step-up token bound to the authenticated Cognito subject. Send it alongside the dashboard Bearer token for workspace-administrator mutations when the base session does not itself prove MFA within the last ten minutes. Never send it with a tenant secret key.

Body

application/json
webhookUrl
string<uri> | null
feeMode
enum<string>
Available options:
pass_through,
absorb
marginPayoutAddress
string | null

Dashboard-session only. A change starts a 24-hour payout hold.

Pattern: ^0x[a-fA-F0-9]{40}$
payoutMethod
enum<string>

Dashboard-session only.

Available options:
usdc,
stripe

Response

Settings updated; no webhook ownership challenge is pending