PApaywithlocus
Tenants

Update tenant settings

Workspace owner/admin sessions and secret keys with tenant:write may update webhookUrl or feeMode. A new webhookUrl is queued for an isolated ownership challenge; the previously verified URL remains active until that challenge succeeds. Requests containing marginPayoutAddress or payoutMethod require a dashboard session from a workspace owner or admin with MFA or passkey step-up completed in the last ten minutes; every other principal receives 403. Changing marginPayoutAddress starts a 24-hour payout hold.

put/credits/tenants/me

Request

  • Base URL
    https://api.paywithlocus.com/api
  • URL
    https://api.paywithlocus.com/api/credits/tenants/me
  • Auth
    • HTTP bearer
    • or HTTP bearer

Headers

X-Locus-Step-Upstring 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.

Request body

webhookUrlstring uri nullable
feeMode'pass_through' | 'absorb'
marginPayoutAddressstring nullable

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

payoutMethod'usdc' | 'stripe'

Dashboard-session only.

Response

Settings updated; no webhook ownership challenge is pending

Changes

No recorded changes to this operation across all 1 revision of this API.