GameMaker Studio · GML · Cloud saves

gmda_deleteSave

Deletes a single cloud save slot.

Asynchronous (result via event)

Signature

gmda_deleteSave(slot)

What it does

POSTs /saves/delete. Idempotent: deleting an already-empty slot still reports success. The queued save_deleted event carries response = { success: true }. On failure the event carries success=false and an error string. Returns 0 immediately (no event) when there is no active session or slot is out of 1..10.

Parameters

Name	Type	Default	Description
slot	real	required	Save slot to delete, 1 to 10.

How to call it

Fire gmda_deleteSave(), then confirm the result in a Step event with gmda_pollEvent() when e.event == "save_deleted".

Result event: save_deleted { success, response }

Example

gmda_deleteSave(1);

// later, in a Step event:
var e = gmda_pollEvent();
while (!is_undefined(e)) {
    if (e.event == "save_deleted") {
        if (e.success) show_debug_message("Slot cleared");
        else show_debug_message("Delete failed: " + string(e.error));
    }
    e = gmda_pollEvent();
}

Use cases

Let a player erase a save slot.
Clear a slot before overwriting it with a fresh game.