---
title: "Update a Fee Rule"
method: PUT
path: "/admin/fees/{id}"
tags: ["Admin"]
---

# Update a Fee Rule

`PUT /admin/fees/{id}`

Updates an existing fee rule by id, for example to change its rate, effective date, or expiry.

## Path parameters

- `id` string, required

## Request body

- object
  - `agents` string[] — Agents the rule targets: empty for 'global', one for 'agent', two for 'pair'.
  - `effectiveFrom` string, date-time — When the rule becomes effective (RFC 3339).
  - `effectiveUntil` string, date-time — Optional expiry after which the rule no longer applies (RFC 3339).
  - `rate` string, required — Fee rate as a non-negative decimal fraction; must not exceed the configured maximum.
  - `reason` string — Free-text justification recorded in the audit trail.
  - `scope` 'global' | 'agent' | 'pair', required — Match scope of the rule.
  - `transactionType` 'sale' | 'payment' | 'subscription' | 'group_fee' | 'revenue_share', required — Fee-bearing ledger transaction type the rule applies to.

## Response `200`

OK

- object

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)