Automatisierungsleitfaden

Get a key in under a minute

Every key is created and scoped from your own server dashboard — never shared, never generated for you.

1. Open Developer API — In your dashboard: server → Admin → Developer API.
2. Create a key, pick scopes — Name it after the agent using it (e.g. "Cursor — ticket setup") and grant only the scopes that task needs.
3. Copy it once — The raw key is shown only at creation. Paste it into the prompt below and hand it to your agent.

Three tiers, one axis: blast radius

The tier you pick when creating a key decides what it's even capable of — independent of which scopes you grant it.

API scopes

• channels_write — Create and edit channels & categories
• channels_delete — Delete a channel
• channels_permissions — Set or clear a permission overwrite
• channels_slowmode — Set a channel's slowmode
• channels_lockdown — Lock or unlock a channel
• roles_write — Create, edit, and reorder roles
• roles_delete — Delete a role
• roles_assign — Bulk-assign a role to a list of members
• webhooks_write — Create and edit webhooks
• webhooks_delete — Delete a webhook
• members_manage — Grant or remove a role from a member
• members_dm — Send a member a direct message as the bot
• members_kick — Kick a member (owner & bot always protected)
• members_ban — Ban or unban a member (owner & bot always protected)
• messages_write — Post a message or embed to a channel
• invites_write — Create an invite link
• invites_delete — Revoke an invite
• tickets_write — Manage ticket categories, settings, and the open-ticket panel
• tickets_delete — Delete a ticket category
• settings_read — Read any guild setting (Welcome, Leveling, AutoMod, and every other settings-driven tab)
• settings_write — Change any guild setting (Welcome, Leveling, AutoMod, and every other settings-driven tab)
• leveling_write — Manage level-up role rewards and per-role/per-channel-category/per-channel XP multipliers (dedicated tables, not covered by settings scopes)
• automod_write — Manage the banned-word list and dry-run the AutoMod filters (dedicated table, not covered by settings scopes)
• self-roles_write — Post a reaction-role panel (a real Discord message + reactions, not just a settings row)
• self-roles_delete — Delete a reaction-role panel or a single emoji/role entry
• verification_write — Post the verify panel to a channel (verification_role/channel must already be configured)
• verification_manage — Manually grant one specific member the verification role
• giveaways_write — Create, end early, or reroll a giveaway
• giveaways_delete — Delete a giveaway and its entries
• polls_write — Create, close early, or extend a poll
• polls_delete — Delete a poll and its votes
• achievements_write — Manage achievement definitions and grant an achievement to a member
• achievements_delete — Delete a definition or revoke a member's achievement
• auto-publish_write — Register a channel, change its settings, or compose+publish an embed
• auto-publish_delete — Remove a channel from auto-publish
• suggestions_write — List suggestions, change status (edits the embed, DMs the author), edit content, and manage categories
• suggestions_delete — Delete a suggestion or category
• custom-commands_write — Manage custom commands, tags, and autoresponders — the 3 sub-tabs of the Custom Commands area
• custom-commands_delete — Delete a custom command, tag, or autoresponder
• scheduled-msgs_write — List, create/edit, pause, reorder, duplicate, test-send scheduled messages, and manage their images/templates
• scheduled-msgs_delete — Delete a scheduled message or template
• bump-reminder_write — Read bump reminder config/stats and save its settings
• bump-reminder_delete — Turn the bump reminder off
• auto-roles_write — List/set join roles (incl. bulk-add), stats, the confirmation panel (incl. test-send), and rule-based auto-role-rules
• auto-roles_delete — Delete a join role or an auto-role-rule
• starboard-boards_write — List/create/edit starboard boards, top messages, stats, threshold simulation, export, and the audit log
• starboard-boards_delete — Delete a starboard board
• economy-config_write — Manage color roles, the color whitelist, the leaderboard, and economy settings (cooldowns, payouts, fishing, embeds)
• economy-config_delete — Delete a color role or a whitelist entry
• directory-listing_write — Read/edit the server directory listing, pause/bump it, upload a banner, and toggle digest inclusion
• directory-listing_delete — Remove the listing's banner
• modmail_write — Read/edit modmail config, open/close threads, block a member, stats, and export a transcript
• modmail_delete — Unblock a member
• supporters_write — Read/edit supporter config, list the roster, add or renew a supporter
• supporters_delete — Remove a supporter
• ticket-queue_write — List/manage the ticket queue — claim, priority, pin, archive, reopen, reply, transcript
• ticket-queue_close — Quick-close a ticket (deletes its Discord channel)
• mod-log_write — Read/add warnings, mod actions, activity, case history, and mod notes
• mod-log_delete — Delete a warning, clear a member's warnings, or delete a mod note
• analytics_read — Messages, top channels, totals, emoji/command usage, and engagement history
• voice-activity_write — Voice leaderboard, channels, live, hall of fame, history, trend, duo, export, and settings
• voice-activity_reset — Bulk-reset everyone's voice activity totals
• reputation_write — Reputation leaderboard, adjust, export, top givers, stats, settings, role rewards, and import
• reputation_delete — Reset a member's reputation, or delete a role reward
• stat-channels_write — List/create/update/reorder/refresh stat counters, history, export, guild config, and audit log
• stat-channels_delete — Delete a stat counter (also deletes its bot-created Discord voice channel)
• temp-voice_write — List/create/update temp voice hubs, active channels, bulk enable/disable, export/import, and templates
• temp-voice_delete — Delete a temp voice hub, a template, or a bulk delete action
• profiles_write — Profile list, settings, stats, and admin audit log
• profiles_delete — Clear a member's bio, or force-divorce a member
• birthday_write — Birthday settings, upcoming list, preview text, stats, audit log, and CSV export/import
• partnerships_write — Partnership status, connect code, connect/accept, settings, invite link, and posts
• partnerships_delete — Revoke a partnership
• antinuke_write — Anti-nuke config (thresholds, action, whitelist) and pause
• antinuke_snapshot — Anti-nuke snapshot list/save/detail and restore
• join-requirements_write — Join-requirements config, pause, stats, pending list, and test
• join-requirements_decide — Approve or deny a pending member
• scam-protection_write — Scam-protection config, stats, and test
• motw_write — Member of the Week config
• activity_read — Activity leaderboard, most-active members, nick history, top channels, heatmap, and CSV export
• giveaway-config_write — Server-wide giveaway defaults
• member-search_write — Member name lookup, settings, recent joins, and audit log
• backup_write — Settings/roles/channels export and additive-only restore
• rank-card_write — Rank-card design config and presets save/apply
• rank-card_delete — Clear a preset, one member's override, or everyone's overrides
• temp-text_write — Temp text channel config, stats, CSV export, and audit-log
• temp-text_delete — Close one or every active temp text channel right now
• feeds_write — Feed CRUD, bulk enable/disable, export/import, templates, and test
• feeds_delete — Remove a feed, bulk-delete feeds, or remove a template
• embed-templates_write — Embed template CRUD, version history/restore, marketplace publish/browse/import, favorite, and usage tracking
• embed-templates_delete — Remove an embed template and its whole version history
• forms_write — Form CRUD, question templates, stats, audit log, and the whole submission review workflow (claim, decide, rubric, notes, appeals)
• forms_delete — Permanently remove a form or a question-template
• archive_write — Channel-archiving settings, preview, run-now, restore, history, and stats
• afk_write — AFK settings, list, export, stats, history, group AFK, and clearing status
• commands_write — Read the command catalog and lockout status, enable/disable a command
• starter-kits_write — Starter kit CRUD, versions, preview, apply, vote, favorite, report, collections, clone, export/import, apply-history, subscribe, schedule, stats, and marketplace browse
• starter-kits_delete — Permanently remove a starter kit or collection, and reverting an apply (deletes real Discord roles/channels)
• ai-assistant_write — AI Assistant settings, listing/confirming/rejecting proposed actions, and audit log
• mood-analytics_write — Mood Analytics trend/summary/heatmap data, export, event markers, alert log, channel alert-override and prompt config, admin feedback, transparency notice, pause, and test-scan
• command-permissions_write — Per-command enable/disable and scoping, temp-disable, usage stats/audit, undo, bulk toggle, presets, export/import, and server-wide command lockdown
• music_write — Music player settings, health check, now-playing/history/stats/errors, playlist list/delete, and now-playing embed customization
• logging_write — Test-send to a log channel, settings audit log, searchable Log Explorer, CSV/JSON export, and weekly stats
• bot-status_write — Bot status summary and guild stats, alert settings, uptime history, restart log, permission-check, infra health, and bot/guild info
• gdpr_write — GDPR settings, delete dry-run, request list/create/cancel, purge-candidates list, PII scan, and data map
• gdpr_delete — Export a member's full personal data, and permanently erase it (delete, approve, or purge)

Ground rules before you connect an agent

• Treat the key like a password — Anyone with it can act as your server within its scopes. Never paste it into a public chat, a committed file, or a prompt you share publicly.
• Start on staging — A staging-tier key physically cannot hold delete/kick/ban scopes — a safe default while you're still trusting an agent with real actions.
• Scope narrowly per agent — Make a separate key per tool or task instead of one key with every scope. If a key leaks, the damage is bounded to what it could actually do.
• Kick and ban are guarded, not gone — The API refuses to kick or ban the server owner or the bot itself — but any other member is real. Keep the agent describing its plan before it acts.
• Rate limits are per key — Each key gets its own request budget (visible via X-RateLimit-* response headers), independent of your dashboard usage.
• Revoke anytime — Pausing or revoking a key from the dashboard takes effect immediately — no need to touch the agent or wait for a restart.