Guide d'automatisation

Comment s'authentifier, quelles portées existent, et des exemples détaillés pour les automatisations les plus courantes.

Claude Code, Cursor, Windsurf, or any automation tool can talk directly to your Discord server through the AscensionBot Developer API — create channels, wire up roles and permissions, build a ticket system, moderate. No bot code, no gateway connection, just an HTTPS call with a bearer token.

Get a key in under a minute

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

Open Developer API — In your dashboard: server → Admin → Developer API.
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.
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.

Staging — Try things safely

Can't hold delete/kick/ban scopes — ever, even if you try to grant them
Rate limit capped to 20% of your server's normal limit
Good default for a first agent connection

Prod — Full control, one server

Any scope, full rate limit
Locked to the server it was created on
What most agents should run on day-to-day

Dev — Cross-server tooling

Only the bot application owner can create or edit one
Can target a different server per-request via target_guild_id
For your own multi-server automation, not for a typical integration

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.