Undo Rank Change

Undo a previously recorded rank change.

POST https://api.sonorancms.com/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo

Rate limit: 13 requests per minute

Authenticated v2 endpoints are rate limited per credential rather than per IP address.

Undo a previously recorded rank change.

Route Parameters

| --- | --- | --- | --- |

Request Body

| --- | --- | --- | --- |

Example Request

local Sonoran = require("sonoran")

local sonoran = Sonoran.createClient({
  product = Sonoran.productEnums.CMS,
  apiKey = "YOUR_API_KEY",
  communityId = "YOUR_COMMUNITY_ID",
  defaultServerId = 1,
  timeoutMs = 30000,
})

local undoId = "00000000-0000-0000-0000-000000000000"
local payload = {
  ["userId"] = "11111111-1111-1111-1111-111111111111"
}

local response = sonoran.cms:undoRankChangeV2(undoId, payload)

if response.success then
  print(response.data)
else
  print(response.reason)
end

const Sonoran = require("sonoran.js");

const instance = Sonoran.instance({
  apiKey: "YOUR_API_KEY",
  communityId: "YOUR_COMMUNITY_ID",
  product: Sonoran.productEnums.CMS,
  serverId: 1,
});

async function main() {
  const undoId = "00000000-0000-0000-0000-000000000000";
  const payload = {
  "userId": "11111111-1111-1111-1111-111111111111"
};

  const response = await instance.cms.undoRankChangeV2(undoId, payload);

  if (response.success) {
    console.log(response.data);
  } else {
    console.error(response.reason);
  }
}

main().catch((error) => {
  console.error(error);
});

from sonoran import Instance, productEnums

instance = Instance(
    apiKey="YOUR_API_KEY",
    communityId="YOUR_COMMUNITY_ID",
    product=productEnums.CMS,
    serverId=1,
)

undoId = "00000000-0000-0000-0000-000000000000"
payload = {
  "userId": "11111111-1111-1111-1111-111111111111"
}

response = instance.cms.undoRankChangeV2(undoId, payload)

if response.success:
    print(response.data)
else:
    print(response.reason)

using Sonoran;
using System.Text.Json;

using var sonoran = new SonoranClient(new SonoranClientOptions
{
    product = SonoranProduct.CMS,
    apiKey = "YOUR_API_KEY",
    communityId = "YOUR_COMMUNITY_ID",
    defaultServerId = 1
});

var undoId = "00000000-0000-0000-0000-000000000000";
var payload = new {
  userId = "11111111-1111-1111-1111-111111111111"
};

var response = await sonoran.Cms.undoRankChangeV2(undoId, payload);

if (response.success)
{
    Console.WriteLine(JsonSerializer.Serialize(response.data));
}
else
{
    Console.WriteLine(response.reason);
}

openapi: "3.0.3"

info:

  title: "Sonoran CMS v2 - Undo Rank Change"

  version: "1.0.0"

  description: "Undo a previously recorded rank change."

servers:

  -

    url: "https://api.sonorancms.com"

paths:

  /v2/community/rank-changes/{undoId}/undo:

    post:

      summary: "Undo Rank Change"

      operationId: "undoRankChange"

      parameters:

        -

          description: "Target rank change undo id."

          name: "undoId"

          in: "path"

          schema:

            type: "string"

            format: "uuid"

          required: true

      requestBody:

        required: true

        content:

          application/json:

            schema:

              type: "object"

      security:

        -

          bearerAuth: []

      responses:

        "200":

          description: "Successful response"

          content:

            application/json:

              schema:

                type: "object"

              example:

                success: true

                data:

                  undoId: "55555555-5555-5555-5555-555555555555"

                  account:

                    accId: "00000000-0000-0000-0000-000000000000"

                    sysStatus: true

                    comStatus: true

                    accName: "ExampleAccount"

                    comName: "Example Community"

                    joinDate: "2026-04-15T00:00:00.000Z"

                    lastLogin: "2026-04-15T00:00:00.000Z"

                    owner: false

                    banned: false

                    banInfo: null

                    banExpiration: null

                    apiIdPreference: 0

                    apiIds:

                      ids: []

                    activeApiIds:

                      - "discord:1234567890"

                    identifiers:

                      idents:

                        -

                          id: "55555555-5555-5555-5555-555555555555"

                          accId: "00000000-0000-0000-0000-000000000000"

                          type: "discord"

                          value: "1234567890"

                          refCount: 1

                          verified: true

                          metadata: {}

                          flagId: null

                          createdAt: "2026-04-15T00:00:00.000Z"

                          updatedAt: null

                    ranks:

                      - "22222222-2222-2222-2222-222222222222"

                    clockData:

                      data:

                        -

                          id: "55555555-5555-5555-5555-555555555555"

                          startTime: "2026-04-15T00:00:00.000Z"

                          endTime: null

                          completed: false

                          notes: []

                          type: "patrol"

                    profileFields:

                      data:

                        -

                          id: "discord"

                          value: "1234567890"

                    bio: null

                    archived: false

                    discordId: "1234567890"

                    robloxId: "987654321"

                    uniqueId: 1001

                    customUniqueId: false

                    notificationPreferences:

                      forms:

                        statusChange:

                          inbox: true

                          desktop: true

                          mobile: true

                          email: true

                          discord: true

                    teamspeakId: null

                  previousRanks:

                    - "11111111-1111-1111-1111-111111111111"

                  currentRanks:

                    - "22222222-2222-2222-2222-222222222222"

                  originalLogId: "44444444-4444-4444-4444-444444444444"

                  reversalUndoId: "33333333-3333-3333-3333-333333333333"

                meta:

                  timestamp: "2026-04-15T00:00:00.000Z"

                  path: "/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo"

components:

  securitySchemes:

    bearerAuth:

      type: "http"

      scheme: "bearer"

      bearerFormat: "JWT"

curl --request POST \

  --url "https://api.sonorancms.com/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo" \

  --header "Authorization: Bearer YOUR_API_KEY" \

  --header "Accept: application/json" \

  --data '{"userId":"11111111-1111-1111-1111-111111111111"}'

Response

The data object contains the undo summary, the updated account, the previous and current ranks, and the original/reversal log ids.


{

  "success": true,

  "data": {

    "undoId": "55555555-5555-5555-5555-555555555555",

    "account": {

      "accId": "00000000-0000-0000-0000-000000000000",

      "sysStatus": true,

      "comStatus": true,

      "accName": "ExampleAccount",

      "comName": "Example Community",

      "joinDate": "2026-04-15T00:00:00.000Z",

      "lastLogin": "2026-04-15T00:00:00.000Z",

      "owner": false,

      "banned": false,

      "banInfo": null,

      "banExpiration": null,

      "apiIdPreference": 0,

      "apiIds": {

        "ids": []

      },

      "activeApiIds": [

        "discord:1234567890"

      ],

      "identifiers": {

        "idents": [

          {

            "id": "55555555-5555-5555-5555-555555555555",

            "accId": "00000000-0000-0000-0000-000000000000",

            "type": "discord",

            "value": "1234567890",

            "refCount": 1,

            "verified": true,

            "metadata": {},

            "flagId": null,

            "createdAt": "2026-04-15T00:00:00.000Z",

            "updatedAt": null

          }

        ]

      },

      "ranks": [

        "22222222-2222-2222-2222-222222222222"

      ],

      "clockData": {

        "data": [

          {

            "id": "55555555-5555-5555-5555-555555555555",

            "startTime": "2026-04-15T00:00:00.000Z",

            "endTime": null,

            "completed": false,

            "notes": [],

            "type": "patrol"

          }

        ]

      },

      "profileFields": {

        "data": [

          {

            "id": "discord",

            "value": "1234567890"

          }

        ]

      },

      "bio": null,

      "archived": false,

      "discordId": "1234567890",

      "robloxId": "987654321",

      "uniqueId": 1001,

      "customUniqueId": false,

      "notificationPreferences": {

        "forms": {

          "statusChange": {

            "inbox": true,

            "desktop": true,

            "mobile": true,

            "email": true,

            "discord": true

          }

        }

      },

      "teamspeakId": null

    },

    "previousRanks": [

      "11111111-1111-1111-1111-111111111111"

    ],

    "currentRanks": [

      "22222222-2222-2222-2222-222222222222"

    ],

    "originalLogId": "44444444-4444-4444-4444-444444444444",

    "reversalUndoId": "33333333-3333-3333-3333-333333333333"

  },

  "meta": {

    "timestamp": "2026-04-15T00:00:00.000Z",

    "path": "/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo"

  }

}

PreviousTrigger Promotion Flows NextCreate Short URL

Last updated 27 days ago

Was this helpful?

openapi: "3.0.3"

info:

  title: "Sonoran CMS v2 - Undo Rank Change"

  version: "1.0.0"

  description: "Undo a previously recorded rank change."

servers:

  -

    url: "https://api.sonorancms.com"

paths:

  /v2/community/rank-changes/{undoId}/undo:

    post:

      summary: "Undo Rank Change"

      operationId: "undoRankChange"

      parameters:

        -

          description: "Target rank change undo id."

          name: "undoId"

          in: "path"

          schema:

            type: "string"

            format: "uuid"

          required: true

      requestBody:

        required: true

        content:

          application/json:

            schema:

              type: "object"

      security:

        -

          bearerAuth: []

      responses:

        "200":

          description: "Successful response"

          content:

            application/json:

              schema:

                type: "object"

              example:

                success: true

                data:

                  undoId: "55555555-5555-5555-5555-555555555555"

                  account:

                    accId: "00000000-0000-0000-0000-000000000000"

                    sysStatus: true

                    comStatus: true

                    accName: "ExampleAccount"

                    comName: "Example Community"

                    joinDate: "2026-04-15T00:00:00.000Z"

                    lastLogin: "2026-04-15T00:00:00.000Z"

                    owner: false

                    banned: false

                    banInfo: null

                    banExpiration: null

                    apiIdPreference: 0

                    apiIds:

                      ids: []

                    activeApiIds:

                      - "discord:1234567890"

                    identifiers:

                      idents:

                        -

                          id: "55555555-5555-5555-5555-555555555555"

                          accId: "00000000-0000-0000-0000-000000000000"

                          type: "discord"

                          value: "1234567890"

                          refCount: 1

                          verified: true

                          metadata: {}

                          flagId: null

                          createdAt: "2026-04-15T00:00:00.000Z"

                          updatedAt: null

                    ranks:

                      - "22222222-2222-2222-2222-222222222222"

                    clockData:

                      data:

                        -

                          id: "55555555-5555-5555-5555-555555555555"

                          startTime: "2026-04-15T00:00:00.000Z"

                          endTime: null

                          completed: false

                          notes: []

                          type: "patrol"

                    profileFields:

                      data:

                        -

                          id: "discord"

                          value: "1234567890"

                    bio: null

                    archived: false

                    discordId: "1234567890"

                    robloxId: "987654321"

                    uniqueId: 1001

                    customUniqueId: false

                    notificationPreferences:

                      forms:

                        statusChange:

                          inbox: true

                          desktop: true

                          mobile: true

                          email: true

                          discord: true

                    teamspeakId: null

                  previousRanks:

                    - "11111111-1111-1111-1111-111111111111"

                  currentRanks:

                    - "22222222-2222-2222-2222-222222222222"

                  originalLogId: "44444444-4444-4444-4444-444444444444"

                  reversalUndoId: "33333333-3333-3333-3333-333333333333"

                meta:

                  timestamp: "2026-04-15T00:00:00.000Z"

                  path: "/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo"

components:

  securitySchemes:

    bearerAuth:

      type: "http"

      scheme: "bearer"

      bearerFormat: "JWT"


{

  "success": true,

  "data": {

    "undoId": "55555555-5555-5555-5555-555555555555",

    "account": {

      "accId": "00000000-0000-0000-0000-000000000000",

      "sysStatus": true,

      "comStatus": true,

      "accName": "ExampleAccount",

      "comName": "Example Community",

      "joinDate": "2026-04-15T00:00:00.000Z",

      "lastLogin": "2026-04-15T00:00:00.000Z",

      "owner": false,

      "banned": false,

      "banInfo": null,

      "banExpiration": null,

      "apiIdPreference": 0,

      "apiIds": {

        "ids": []

      },

      "activeApiIds": [

        "discord:1234567890"

      ],

      "identifiers": {

        "idents": [

          {

            "id": "55555555-5555-5555-5555-555555555555",

            "accId": "00000000-0000-0000-0000-000000000000",

            "type": "discord",

            "value": "1234567890",

            "refCount": 1,

            "verified": true,

            "metadata": {},

            "flagId": null,

            "createdAt": "2026-04-15T00:00:00.000Z",

            "updatedAt": null

          }

        ]

      },

      "ranks": [

        "22222222-2222-2222-2222-222222222222"

      ],

      "clockData": {

        "data": [

          {

            "id": "55555555-5555-5555-5555-555555555555",

            "startTime": "2026-04-15T00:00:00.000Z",

            "endTime": null,

            "completed": false,

            "notes": [],

            "type": "patrol"

          }

        ]

      },

      "profileFields": {

        "data": [

          {

            "id": "discord",

            "value": "1234567890"

          }

        ]

      },

      "bio": null,

      "archived": false,

      "discordId": "1234567890",

      "robloxId": "987654321",

      "uniqueId": 1001,

      "customUniqueId": false,

      "notificationPreferences": {

        "forms": {

          "statusChange": {

            "inbox": true,

            "desktop": true,

            "mobile": true,

            "email": true,

            "discord": true

          }

        }

      },

      "teamspeakId": null

    },

    "previousRanks": [

      "11111111-1111-1111-1111-111111111111"

    ],

    "currentRanks": [

      "22222222-2222-2222-2222-222222222222"

    ],

    "originalLogId": "44444444-4444-4444-4444-444444444444",

    "reversalUndoId": "33333333-3333-3333-3333-333333333333"

  },

  "meta": {

    "timestamp": "2026-04-15T00:00:00.000Z",

    "path": "/v2/community/rank-changes/11111111-1111-1111-1111-111111111111/undo"

  }

}