Docs
Find a command. Open it for options and examples.
Need help?New to Cyra?
Invite Cyra, then use /setup to choose your channels and modules. Keep Cyra’s role above the roles she manages.
Run commands in Discord. <argument> is required; [argument] is optional. Permissions and role hierarchy still apply.
Antiscam
Review scam detections and choose how your server responds.
/antiscam settingsManage scam protection, references, exceptions and cases.
Link to this command
Usage
/antiscam settings
Good to know
- Start in Observe mode to review detections without automatic sanctions. Protect mode uses your chosen local action: review, timeout, kick or ban.
- Configure a private staff alert channel. Kick, Ban and Ignore apply to incidents in this server. Account histories and incident evidence are not sent to other servers.
- Use Apps → Add scam image to submit an image for private review. Only approved image fingerprints become global references; submitting a report does not sanction the author.
Community
Polls, suggestions, giveaways and AFK status.
/afk clearClear your away status in this server.
Link to this command
Usage
/afk clear
Good to know
- Clears your own AFK in this server. It does not change another member’s status.
/afk setMark yourself as away in this server.
Link to this command
Usage
/afk set[reason]
Options
Good to know
- Your AFK applies only in this server. Sending a message clears it; members who mention you receive an AFK notice.
/afk statusCheck your own or another member's away status.
Link to this command
Usage
/afk status[user]
Options
Good to know
- Omit user to check your own AFK. This reads the status without changing it.
/giveaway cancelCancel a giveaway without selecting winners.
Link to this command
Usage
/giveaway cancel<giveaway_id>
Options
Good to know
- Closes the giveaway without drawing winners. Cancelled giveaways cannot be rerolled.
/giveaway createCreate a persistent giveaway in a server channel.
Link to this command
Usage
/giveaway create<prize><duration><channel>[winners]
Options
Good to know
- Use a duration such as 1h30m or 7d, from one minute to 30 days. Choose 1–20 winners; up to 20 giveaways can be active in this server.
- Members enter or withdraw using the published button. The organizer is responsible for delivering the prize.
/giveaway endEnd a giveaway and save its winners.
Link to this command
Usage
/giveaway end<giveaway_id>
Options
Good to know
- Draws winners before the deadline. If there are fewer entrants than requested winners, all entrants win. An empty giveaway closes without winners.
/giveaway listList active giveaways in this server.
Link to this command
Usage
/giveaway list
Good to know
- Lists this server’s active giveaways and their IDs. Use those IDs to end or cancel a giveaway.
/giveaway rerollSelect replacement winners and preserve the draw history.
Link to this command
Usage
/giveaway reroll<giveaway_id>
Options
Good to know
- Works only on a finished giveaway. Chooses replacements from entrants who have never won a previous round and keeps the draw history.
/pollCreate a poll with 2–5 options separated by |.
Link to this command
Usage
/poll<question><options>[duration]
Options
Good to know
- Separate 2–5 answer options with |. Each option allows 80 characters; duration is one minute to seven days. Up to 20 polls can be active per server.
- Each member has one vote and can change it. The author or an administrator can close the poll.
/suggestSubmit a suggestion for members to vote on.
Link to this command
Usage
/suggest<content>
Options
Good to know
- Posts your suggestion with voting buttons. Up to 100 suggestions can be pending in this server.
/suggestion acceptAccept a pending suggestion from this server.
Link to this command
Usage
/suggestion accept<suggestion_id><reason>
Options
Good to know
- Use the pending suggestion’s ID and explain the decision. The result is saved even if Cyra cannot edit the original card.
/suggestion rejectReject a pending suggestion from this server.
Link to this command
Usage
/suggestion reject<suggestion_id><reason>
Options
Good to know
- Use the pending suggestion’s ID and explain why it was rejected. The result is saved even if Cyra cannot edit the original card.
Creators & social media
Creator profiles and publication notifications.
/instagram notifier disableStop watching a public profile.
Link to this command
Usage
/instagram notifier disable<username>
Options
Good to know
- Stops this server’s notifier for the specified username.
/instagram notifier previewPreview a saved notifier privately.
Link to this command
Usage
/instagram notifier preview<username>
Options
Good to know
- Previews the notification for the specified username. It does not enable a new notifier.
/instagram notifier setupNotify a channel when a profile posts.
Link to this command
Usage
/instagram notifier setup<channel>[mention]
Options
Good to know
- Opens the notifier editor for the chosen destination. Templates support {mention}, {url} and {username}. Up to ten notifiers can be active in this server.
- Checks for updates every five minutes. Cyra needs View Channel, Send Messages and Embed Links; a role that is not mentionable also needs Mention Everyone in this channel.
/instagram profileShow a public social profile.
Link to this command
Usage
/instagram profile<username>
Options
Good to know
- Reads a public profile. Up to three profile queries per 30 seconds per user; platform blocks or page changes may temporarily prevent results.
/kickstream notifier disableStop watching a public profile.
Link to this command
Usage
/kickstream notifier disable<username>
Options
Good to know
- Stops this server’s notifier for the specified username.
/kickstream notifier previewPreview a saved notifier privately.
Link to this command
Usage
/kickstream notifier preview<username>
Options
Good to know
- Previews the notification for the specified username. It does not enable a new notifier.
/kickstream notifier setupNotify a channel when a profile posts.
Link to this command
Usage
/kickstream notifier setup<channel>[mention]
Options
Good to know
- Opens the notifier editor for the chosen destination. Templates support {mention}, {url} and {username}. Up to ten notifiers can be active in this server.
- Checks for updates every five minutes. Cyra needs View Channel, Send Messages and Embed Links; a role that is not mentionable also needs Mention Everyone in this channel.
/kickstream profileShow a public social profile.
Link to this command
Usage
/kickstream profile<username>
Options
Good to know
- Reads a public profile. Up to three profile queries per 30 seconds per user; platform blocks or page changes may temporarily prevent results.
/tiktok notifier disableStop watching a public profile.
Link to this command
Usage
/tiktok notifier disable<username>
Options
Good to know
- Stops this server’s notifier for the specified username.
/tiktok notifier previewPreview a saved notifier privately.
Link to this command
Usage
/tiktok notifier preview<username>
Options
Good to know
- Previews the notification for the specified username. It does not enable a new notifier.
/tiktok notifier setupNotify a channel when a profile posts.
Link to this command
Usage
/tiktok notifier setup<channel>[mention]
Options
Good to know
- Opens the notifier editor for the chosen destination. Templates support {mention}, {url} and {username}. Up to ten notifiers can be active in this server.
- Checks for updates every five minutes. Cyra needs View Channel, Send Messages and Embed Links; a role that is not mentionable also needs Mention Everyone in this channel.
/tiktok profileShow a public social profile.
Link to this command
Usage
/tiktok profile<username>
Options
Good to know
- Reads a public profile. Up to three profile queries per 30 seconds per user; platform blocks or page changes may temporarily prevent results.
/twitch notifier disableStop watching a public profile.
Link to this command
Usage
/twitch notifier disable<username>
Options
Good to know
- Stops this server’s notifier for the specified username.
/twitch notifier previewPreview a saved notifier privately.
Link to this command
Usage
/twitch notifier preview<username>
Options
Good to know
- Previews the notification for the specified username. It does not enable a new notifier.
/twitch notifier setupNotify a channel when a profile posts.
Link to this command
Usage
/twitch notifier setup<channel>[mention]
Options
Good to know
- Opens the notifier editor for the chosen destination. Templates support {mention}, {url} and {username}. Up to ten notifiers can be active in this server.
- Checks for updates every five minutes. Cyra needs View Channel, Send Messages and Embed Links; a role that is not mentionable also needs Mention Everyone in this channel.
/twitch profileShow a public social profile.
Link to this command
Usage
/twitch profile<username>
Options
Good to know
- Reads a public profile. Up to three profile queries per 30 seconds per user; platform blocks or page changes may temporarily prevent results.
/youtube channelLook up a public YouTube channel by handle, URL or ID.
/youtube live disableDisable this notification type for a YouTube channel.
/youtube live previewPreview a saved YouTube notifier privately.
/youtube live setupChoose a destination and edit this YouTube notifier.
/youtube videos disableDisable this notification type for a YouTube channel.
/youtube videos previewPreview a saved YouTube notifier privately.
/youtube videos setupChoose a destination and edit this YouTube notifier.
Games
Quick games to play in chat.
/aion equipmentInspect a public character's equipped items.
/aion profileShow a public character profile; type a name and choose an autocomplete result.
/aion searchFind public characters and open their interactive profile.
/aion timersShow Global event countdowns and optional personal reminders.
/coinflipFlip a coin.
/diceRoll up to 10 dice with 2–100 sides.
Link to this command
Usage
/dice[sides][count]
Options
Good to know
- Defaults to one six-sided die when both options are omitted. Shows each roll and their total.
/rpsPlay rock-paper-scissors against Cyra or another member.
Link to this command
Usage
/rps[opponent]
Options
Good to know
- Omit opponent to play against Cyra, or choose another human member. Only the participants can use the game controls; unfinished games expire.
/tictactoeChallenge another member to tic-tac-toe.
Link to this command
Usage
/tictactoe<opponent>
Options
Good to know
- Choose another human member. Only the two players can take turns; an unfinished game expires and is not restored after a bot restart.
Levels & XP
Ranks, leaderboards and role rewards.
/leaderboardView top ranked users
/levelconfigConfigure level system
/levelrewardAdd role reward for a level
/levelrewardsView all level rewards
/rankView your level and rank
Moderation
Manage members, sanctions and channel access.
/banBan a member without deleting their messages.
Link to this command
Usage
/ban<member><reason>
Options
Good to know
- Cyra and your highest role must be above the target. This command bans the member without deleting their message history.
/caseView a moderation case from this server.
Link to this command
Usage
/case<case_id>
Options
Good to know
- Looks up a moderation case by ID in this server. Case IDs from another server do not grant access to its records.
/kickKick a member from this server.
Link to this command
Usage
/kick<member><reason>
Options
Good to know
- Cyra and your highest role must be above the target. The member is removed from the server, but is not banned.
/lockDeny @everyone Send Messages, preserving the previous value.
Link to this command
Usage
/lock<reason>
Options
Good to know
- Saves and denies Send Messages for @everyone in this channel. Explicit permissions from other roles may still allow members to write.
/purgeDelete up to 100 recent messages from this channel.
Link to this command
Usage
/purge<amount><reason>[member]
Options
Good to know
- Inspects up to 100 recent messages. If member is supplied, only matching messages within that inspected range are removed.
/slowmodeSet slowmode; use 0 to disable.
Link to this command
Usage
/slowmode<seconds><reason>
Options
Good to know
- Sets the interval between messages in this channel. Zero turns slowmode off.
/timeoutTime out a member for 1 minute to 28 days.
Link to this command
Usage
/timeout<member><duration><reason>
Options
Example
/timeout member:@Luna duration:10m reason:Repeated spam
Good to know
- Use a duration such as 10m or 1h, from one minute to 28 days. Both your role and Cyra’s role must be able to act on the target.
/unbanRemove a ban by Discord user ID.
Link to this command
Usage
/unban<user_id><reason>
Options
Good to know
- Supply the banned account’s Discord user ID. The member does not need to be present in the server.
/unlockRestore the Send Messages value saved by /lock.
Link to this command
Usage
/unlock<reason>
Options
Good to know
- Restores the @everyone Send Messages value saved by /lock, without changing other channel permissions.
/untimeoutRemove a member's timeout.
Link to this command
Usage
/untimeout<member><reason>
Options
Good to know
- Removes the selected member’s timeout, subject to permissions and role hierarchy.
/unwarnRevoke a warning while preserving its audit history.
Link to this command
Usage
/unwarn<case_id><reason>
Options
Good to know
- Supply the warning’s case ID. Revokes that warning and records the reason in this server’s case history.
/warnRecord a warning for a member.
Link to this command
Usage
/warn<member><reason>
Options
Good to know
- Records a warning as a moderation case in this server. It does not kick, ban or time out the member.
/warningsList a member's active warnings in this server.
Link to this command
Usage
/warnings<member>[page]
Options
Good to know
- Shows the member’s latest 50 active warnings in this server, five per page.
Profiles & identity
Your profile, bio, colors and links.
/identity deleteDelete your saved identity data.
Link to this command
Usage
/identity delete
Good to know
- Requires confirmation within 60 seconds. Deletes your saved identity and its public links.
/identity editEdit your bio, status, color and public links.
Link to this command
Usage
/identity edit
Good to know
- Opens your identity editor. Bio allows 240 characters, status 60, and you can save up to three HTTPS links.
/identity showShow a personal identity card. Saved text is public.
Link to this command
Usage
/identity show[user]
Options
Good to know
- Omit user to show your own card. Saved bio, status and links are public and shared across servers.
/profile customizeCustomize your bio, status, color and public links.
Link to this command
Usage
/profile customize
Good to know
- Opens an editor for your bio, status, #RRGGBB color and up to three HTTPS links. Saved changes also appear on your identity card.
/profile linksList, add/update or remove one of your three public profile links.
Link to this command
Usage
/profile links[action][label][url]
Options
Good to know
- Use the action option to list, add/update or remove your public links. Links must use HTTPS; the free limit is three.
/profile showView a user's profile card.
Link to this command
Usage
/profile show[user]
Options
Good to know
- Omit user to show your own profile. Bot profiles are not supported. Your banner supplies the accent when available; otherwise Cyra uses your saved color.
Reminders
Personal reminders delivered by DM.
/reminder cancelCancel a reminder or stop a recurring reminder.
Link to this command
Usage
/reminder cancel<reminder_id>
Options
Good to know
- Use the ID of a reminder you own. Cancelling a recurring reminder stops future deliveries; a DM already being sent may still arrive.
/reminder createCreate a one-time reminder, from 1 minute to 1 year.
Link to this command
Usage
/reminder create<duration><message>
Options
Example
/reminder create duration:30m message:Take a break
Good to know
- Use a delay such as 10m or 1h30m, from one minute to one year. The reminder arrives by DM; up to ten can be active at once.
- Delivery is checked every 15 seconds, so it may arrive slightly after the scheduled time.
/reminder editEdit the message or next delivery time of an active reminder.
Link to this command
Usage
/reminder edit<reminder_id>[message][duration]
Options
Good to know
- Provide a new message, a new delay, or both. Changing the next delivery time does not change a recurring reminder’s interval.
/reminder listList your active reminders, including retries and recurring reminders.
Link to this command
Usage
/reminder list
Good to know
- Shows your active reminders and their IDs. Use an ID from this list with /reminder edit or /reminder cancel.
/reminder repeatCreate a recurring DM reminder; interval between 15 minutes and 1 year.
Link to this command
Usage
/reminder repeat<interval><message>
Options
Good to know
- Use an interval such as 30m or 1d, from 15 minutes to one year. Deliveries arrive by DM. Stop the recurrence with /reminder cancel.
Server setup & logs
Set up channels, modules and staff logs.
/configView this server's current Cyra configuration.
Link to this command
Usage
/config
Good to know
- Shows this server’s saved configuration. Use /setup or the feature’s configuration command to change it.
/diagnoseCheck Cyra's configuration and runtime health.
Link to this command
Usage
/diagnose
Good to know
- Checks health, permissions and configured resources without changing them.
/logs configureConfigure log categories and destinations.
Link to this command
Usage
/logs configure
Good to know
- Opens the logging editor to select categories and destinations. Message and voice logging are disabled by default.
/logs disableDisable all log destinations; case history is preserved.
/logs ignoreExclude or include a channel in message logs.
Link to this command
Usage
/logs ignore<channel>[ignored]
Options
Good to know
- Adds or removes a channel from the log exclusions. Set ignored to false to include it again.
/logs setupChoose the default destination for server logs.
Link to this command
Usage
/logs setup<channel>
Options
Good to know
- Sets the general destination for Cyra logs. Use /logs configure for category-specific destinations.
/logs statusShow logging destinations and missing permissions.
Link to this command
Usage
/logs status
Good to know
- Checks configured log destinations and Cyra’s permissions. It does not send a test message.
/logs testSend a test card to a configured log destination.
Link to this command
Usage
/logs test[category]
Options
Good to know
- Sends a real test message to the configured destination for the selected category.
/modulesList optional modules or enable/disable one for this server.
Link to this command
Usage
/modules[module][enabled]
Options
Good to know
- Omit the options to list module states. To change one, provide both module and enabled.
- Disabling a module keeps its saved data. Existing personal reminders continue to run.
/setupConfigure this server with guided controls.
Link to this command
Usage
/setup[theme]
Options
Good to know
- Opens a private setup panel. Each selection is saved immediately; clearing a channel or role selection disables that resource. Only the person who opened the panel can change it, and it expires after five minutes.
Support tickets
Private support channels and ticket transcripts.
/tickets addAdd a member to the current ticket.
Link to this command
Usage
/tickets add<member>
Options
Good to know
- Run inside the ticket channel as support staff or with Manage Channels. Gives the selected member access to that ticket.
/tickets customizeEdit the persistent ticket panel content.
Link to this command
Usage
/tickets customize
Good to know
- Opens the panel editor and updates the existing ticket panel after saving. It does not rename an individual ticket.
/tickets deleteArchive the transcript and delete this ticket channel after confirmation.
Link to this command
Usage
/tickets delete
Good to know
- Support staff can retry deletion of a closed ticket after confirmation. The channel is kept if its transcript cannot be archived safely.
/tickets removeRemove a member from the current ticket.
Link to this command
Usage
/tickets remove<member>
Options
Good to know
- Run inside the ticket channel as support staff or with Manage Channels. Removes the selected member’s ticket-specific access; the ticket owner cannot be removed.
/tickets renameRename the current ticket channel.
Link to this command
Usage
/tickets rename<name>
Options
Good to know
- Run inside the ticket channel as support staff or with Manage Channels. Changes this channel’s name, not the public panel.
/tickets reopenReopen a closed ticket in the current channel.
Link to this command
Usage
/tickets reopen
Good to know
- Run inside a closed ticket as support staff or with Manage Channels. Reopens that ticket for further conversation.
/tickets setupPublish or move the persistent ticket panel.
Link to this command
Usage
/tickets setup<panel_channel><category><support_role>[log_channel]
Options
Good to know
- Publishes or moves the ticket panel. Members open tickets from its button and supply a subject and description; only one active ticket per member is allowed.
- Closing requires a complete transcript in a private log channel before the ticket channel is deleted. If archiving fails, the channel is kept.
/tickets transcriptDownload a private HTML transcript of the current ticket.
Link to this command
Usage
/tickets transcript
Good to know
- Downloads a private HTML transcript of up to 1000 recent messages. You must own the ticket or have support access and permission to read its history. Partial exports are marked.
Utilities
Discord information, images and help.
/avatarView a user's avatar.
Link to this command
Usage
/avatar[user]
Options
Good to know
- Omit user to show your own avatar. The image links to its full-size version.
/bannerView a user's global banner.
Link to this command
Usage
/banner[user]
Options
Good to know
- Omit user to show your own global banner. If that account has no banner, Cyra reports that instead.
/helpBrowse Cyra commands by category.
Link to this command
Usage
/help
Good to know
- Opens private help with category selection and eight commands per page.
/inviteInvite Cyra to another server.
Link to this command
Usage
/invite
Good to know
- Opens the installation link for a server you manage. Cyra requests functional permissions without Administrator.
/pingCheck Cyra's gateway latency.
/roleinfoView a role's public information and permissions.
/serverbannerView this server's banner.
/servericonView this server's icon.
/serverinfoView this server's information.
/supportFind Cyra's official support page or server.
Voice rooms
Create and manage temporary voice rooms.
/voice claimClaim your current room when its owner is no longer inside.
Link to this command
Usage
/voice claim
Good to know
- You must be inside the managed room, and its current owner must be absent. Claim makes you the new owner.
/voice forgetForget your global room name and user limit preferences.
/voice limitSet your room's user limit; zero means unlimited.
Link to this command
Usage
/voice limit<amount>
Options
Good to know
- Run this in your managed room. Zero means unlimited capacity; changing the limit does not remove people already inside.
/voice lockLock entry to your room except for its owner and permitted members.
Link to this command
Usage
/voice lock
Good to know
- Run this in your managed room. Blocks new connections while preserving access for the owner, Cyra and permitted members; current occupants are not disconnected. Administrators retain Discord’s native access exception.
/voice nameRename your current temporary voice room.
Link to this command
Usage
/voice name<name>
Options
Good to know
- Run this while connected to the managed room you own, or with Manage Server. The name must contain 1–100 characters.
/voice permitAllow a server member into your room.
Link to this command
Usage
/voice permit<member>
Options
Good to know
- Grants the selected member access to your current managed room, including when it is locked.
/voice rejectDeny entry and remove an unprotected member from your room.
Link to this command
Usage
/voice reject<member>
Options
Good to know
- Denies access and disconnects the selected member if they are inside. You cannot reject the owner, Cyra, the server owner or server administrators/managers.
/voice transferTransfer ownership to a human member currently inside the room.
Link to this command
Usage
/voice transfer<member>
Options
Good to know
- The new owner must be a human in the room and must not already own another managed room. Transferring also changes who can use the room controls.
/voice unlockRestore the room's original Connect permissions.
Link to this command
Usage
/voice unlock
Good to know
- Restores the room’s original Connect permissions while keeping individual permit/reject decisions.
/voicemaster disableStop creating rooms and preserve existing temporary rooms.
Link to this command
Usage
/voicemaster disable
Good to know
- Stops new rooms. Existing rooms keep their controls and are still cleaned up when empty.
/voicemaster setupChoose the join-to-create voice channel and destination category.
Link to this command
Usage
/voicemaster setup<lobby><category>
Options
Good to know
- Choose a normal voice lobby and a destination category in this server. Joining the lobby creates a temporary room and moves the member into it.
- Cyra needs View Channel, Connect and Move Members in both locations, plus Manage Channels, Manage Roles, Send Messages and Read Message History in the destination category.
/voicemaster statusShow the configured lobby, category and managed room count.
Link to this command
Usage
/voicemaster status
Good to know
- Shows the saved lobby, destination category and managed room count. It does not change the configuration.
Welcomes & roles
Greet new members and assign their first role.
/autorole disableStop assigning roles to new members.
Link to this command
Usage
/autorole disable
Good to know
- Stops assigning the automatic role to future members.
/autorole setAssign a safe role to new human members.
Link to this command
Usage
/autorole set<role>
Options
Good to know
- Choose a role below both your highest role and Cyra’s role. You need Manage Roles, and the role cannot grant management permissions. New human members receive it when they join.
/welcome customizeOpen the full visual welcome-card editor.
Link to this command
Usage
/welcome customize[image]
Options
Good to know
- Opens the saved welcome editor: title, message, image, footer and up to two URL buttons. Use HTTPS URLs; you can also supply an image attachment.
- Separate button URLs with |. Template placeholders are {user}, {server} and {count}.
/welcome disableStop welcome messages without deleting the saved template.
/welcome previewPreview this server's welcome card privately.
Link to this command
Usage
/welcome preview
Good to know
- Previews the saved welcome card so you can check its text and appearance before a new member joins.
/welcome setupSet welcome channel and text; placeholders: {user}, {server}, {count}.
Link to this command
Usage
/welcome setup<channel>[message]
Options
Example
/welcome setup channel:#welcome message:Welcome {user} to {server}!
Good to know
- Choose where new-member greetings are sent. The message supports {user}, {server} and {count}.