---
title: "Update Payout Group"
method: PUT
path: "/rewards/payout-groups/{id}"
tags: ["Payout Groups"]
---

# Update Payout Group

`PUT /rewards/payout-groups/{id}`

Updates a payout group. Any changes to a payout group which has an on-chain component
will cause the unclaimed rewards for that group to be implicitly claimed. No details of
the implicit claiming are returned in this API response.

## Path parameters

- `id` string, required

## Request body

- RewardsPayoutGroupServiceUpdatePayoutGroupBody
  - `name` string
  - `jurisdiction` string

## Response `200`

A successful response.

- UpdatePayoutGroupResponse
  - `group` PayoutGroup
    - `id` string, required
    - `ledger` string, required
    - `asset_type` string, required
    - `rate_id` string, required
    - `jurisdiction` string, required
    - `name` string
    - `claimer_address` string, required — Address with signing authority to claim rewards for this group.
    - `manager_address` string — Address that manages this payout group. Defaults to claimer_address if not explicitly set.
    - `destination_address` string — Address that receives reward payouts for this group. Defaults to claimer_address if not explicitly set.
    - `onchain_group_id` string, int64
    - `onchain_status` 'UNREGISTERED' | 'PENDING_REGISTRATION' | 'NEEDS_REREGISTRATION' | 'ACTIVE' | 'FAILED_REGISTRATION' | 'PENDING_DELETION' | 'FAILED_DELETION' | 'PENDING_MULTIPLIER_UPDATE' | 'MULTIPLIER_UPDATE_FAILED' | 'UNREGISTERED_INSUFFICIENT_BALANCE', required — PayoutGroupOnchainStatus represents the on-chain registration status of a payout group.
    - `balance` string, required — Current balance of addresses in this payout group. Does not include any pending/unclaimed rewards.
    - `balance_at` string, date-time
    - `last_claim_all_at` string, date-time
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

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