---
title: "Update tenant settings"
method: PUT
path: "/credits/tenants/me"
tags: ["Tenants"]
---

# Update tenant settings

`PUT /credits/tenants/me`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/tenants/me`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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.

## Headers

- `X-Locus-Step-Up` string, password

## Request body

- object
  - `webhookUrl` string, uri, nullable
  - `feeMode` 'pass_through' | 'absorb'
  - `marginPayoutAddress` string, nullable: Dashboard-session only. A change starts a 24-hour payout hold.
  - `payoutMethod` 'usdc' | 'stripe': Dashboard-session only.

## Response `200`

Settings updated; no webhook ownership challenge is pending

## Other responses

- `202`: Settings updated and webhook ownership verification queued
- `400`: Invalid setting or one or more unknown fields
- `403`: INSUFFICIENT_SCOPE, STEP_UP_REQUIRED for a payout-setting change, a secret key attempted a dashboard-only payout change, or payouts are locked for an evaluation workspace

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)