invite_delete
Delete an invite code. Use it to revoke a code early or to clear out expired and used-up codes, which the server keeps until someone deletes them.
Request
Section titled “Request”{ "cmd": "invite_delete", "code": "3F9A1C7E52B4" }| Field | Type | Required | Description |
|---|---|---|---|
code |
string | Yes | The invite code. The server trims it and uppercases it before looking it up. |
Response
Section titled “Response”{ "cmd": "invite_delete", "code": "3F9A1C7E52B4", "deleted": true }The deletion is recorded in the audit log. Nobody else is notified.
Users who already redeemed the code stay on the whitelist. Remove them with whitelist_remove.
Permissions
Section titled “Permissions”Requires manage_access. A user in timeout gets a rate_limit frame instead.
Errors
Section titled “Errors”val |
When |
|---|---|
Invite not found |
No invite has that code, or the server couldn’t save the change. |
A missing or empty code returns the schema validator’s message.