Edit rev share

Replaces an existing scheduled revenue-share window in full: whatever revShare and tierRevenueShares you send become the schedule’s entire configuration. This is not a partial patch. If you omit tierRevenueShares on an edit, any tier overrides from the previous version are dropped, not preserved.

startDate and endDate are required on every call. The 409 conflict check runs again on the new window against every other schedule for the group, excluding the one being edited.

Send revShare as a percentage from 1 to 100, and avoid sending exactly 1.

Authorizations

X-SHARED-SECRET

required

stringheader

Send your secret API key (nexus_sk_...) in the X-SHARED-SECRET header. Generate one in the Publisher Dashboard.

Parameters

Path Parameters

scheduledRevShareId

required

string

Example

2ixlNNFdJh-9scoXek80w

The scheduled rev share’s id (ScheduledRevShare.uuid), a 21-character nanoid.

Query Parameters

groupId

string

Example

V1StGXR8_Z5jdHi6B1LiO

Creator group the schedule belongs to. If your key is scoped to a single program, that group is always used regardless of this value; otherwise falls back to your default group when omitted.

Request Body

application/json

object

revShare

Flat revenue-share percentage for the whole group during this window, 1 to 100. This replaces, not merges with, the previous configuration.

number

Example

startDate

Start of the override window. ISO 8601, in UTC.

string format: date-time

Example

2026-03-13T17:32:28Z

endDate

End of the override window. Must not be earlier than startDate (equal timestamps are accepted). ISO 8601, in UTC.

string format: date-time

Example

2026-03-20T17:32:28Z

tierRevenueShares

Array<object>

object

revShare

This tier’s revenue-share percentage for the window, 1 to 100.

number

Example

tierId

The tier’s id, as returned by GET /manage/tiers (the tier’s uuid, not its name).

string

Example

2ixlNNFdJh-9scoXek80w

Responses

200

Scheduled rev share that was updated

application/json

object

string

revShare

Group-wide revenue-share percentage for this schedule’s window (25 means 25%). Falls back to the group’s normal, non-scheduled default when the schedule only carries tier-specific overrides.

number

startDate

string format: date-time

endDate

string format: date-time

groupId

string

groupName

string

tierRevenueShares

Array<object>

object

revShare

number

tierId

string

tierName

string

400

Invalid request body or end date is before start date

404

groupId did not match a creator group on your account, or scheduledRevShareId did not match any schedule for that group.

409

The new window overlaps another active or scheduled (non-deleted) revenue share for this group.

PUT

/manage/scheduled-rev-shares/{scheduledRevShareId}

const url = 'https://api.nexus.gg/v1/manage/scheduled-rev-shares/2ixlNNFdJh-9scoXek80w?groupId=V1StGXR8_Z5jdHi6B1LiO';
const options = {
  method: 'PUT',
  headers: {
    'X-SHARED-SECRET': 'nexus_sk_your_key_here',
    'Content-Type': 'application/json'
  },
  body: '{"revShare":25,"startDate":"2026-03-13T17:32:28Z","endDate":"2026-03-20T17:32:28Z","tierRevenueShares":[{"revShare":30,"tierId":"2ixlNNFdJh-9scoXek80w"}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url 'https://api.nexus.gg/v1/manage/scheduled-rev-shares/2ixlNNFdJh-9scoXek80w?groupId=V1StGXR8_Z5jdHi6B1LiO' \
  --header 'Content-Type: application/json' \
  --header 'X-SHARED-SECRET: nexus_sk_your_key_here' \
  --data '{ "revShare": 25, "startDate": "2026-03-13T17:32:28Z", "endDate": "2026-03-20T17:32:28Z", "tierRevenueShares": [ { "revShare": 30, "tierId": "2ixlNNFdJh-9scoXek80w" } ] }'

Example

{
  "id": "2ixlNNFdJh-9scoXek80w",
  "revShare": 25,
  "startDate": "2026-03-13T17:32:28Z",
  "endDate": "2026-03-20T17:32:28Z",
  "groupId": "V1StGXR8_Z5jdHi6B1LiO",
  "groupName": "Aurora Drift Creators",
  "tierRevenueShares": [
    {
      "revShare": 30,
      "tierId": "mK4pQ2xR9vLtN0bWdZ7yA",
      "tierName": "Silver"
    }
  ]
}