---
title: "Updates recurring payouts for a group-owned universe."
method: PATCH
path: "/v1/universes/{universeId}/payouts"
tags: ["Groups", "Universes"]
---

# Updates recurring payouts for a group-owned universe.

`PATCH /v1/universes/{universeId}/payouts`

## Request

- Base URL: `https://groups.roblox.com`
- URL: `https://groups.roblox.com/v1/universes/{universeId}/payouts`
- Auth: API key in cookie `.ROBLOSECURITY`

## Path parameters

- `universeId` integer, required

## Request body

- PublicUpdateUniverseRecurringPayoutsRequestModel: Request for updating recurring payouts through the public groups API.
  - `payouts` PublicRecurringPayoutRequestModel[], required: The recurring payout splits to apply.
    - `userId` integer, required: The payout recipient user ID.
    - `percentage` integer, required: The recipient's payout percentage.

## Response `200`

Success

- PublicAllGroupUniversePayoutsResponseModel: Public response for recurring payouts.
  - `payouts` PublicGroupUniversePayout[], nullable
    - `userId` integer
    - `percentage` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-19** `33047aba4a3d`: 4 info
  - removed the `RoleIdMigrationInProgress` enum value from the `code` response property for the response status `400`
  - removed the `RoleIdMigrationInProgress` enum value from the `code` response property for the response status `401`
  - removed the `RoleIdMigrationInProgress` enum value from the `code` response property for the response status `403`
  - removed the `RoleIdMigrationInProgress` enum value from the `code` response property for the response status `404`
- **2026-10-14** `5dcfa33df56a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/universes/:universeId/payouts/patch.md)

---

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