Discord

Overview

Use Discord credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	discord
Category	Communication
Credential Type	Bot Token

Step 1: Get Credentials

Log in to the Discord Developer Portal

Log in at discord.com/developers/applications.

Select the application

Select the application (or create a new one).

Go to the Bot section

Go to the Bot section in the left sidebar.

Reset Token

Click ‘Reset Token’ to generate a new bot token (this will invalidate any previously issued token).

Copy the bot token

Copy the bot token.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Discord

Go to Managed Secrets > Add Provider > Discord.

Enter credentials

Paste your Bot Token into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.POST,
    "https://discord.com/api/v10/channels/YOUR_CHANNEL_ID/messages",
    grant_id="YOUR_GRANT_ID",
    json={"content": "Hello from Alter"},
)

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
create_message	send	POST	/channels/{channel_id}/messages
execute_webhook	send	POST	/webhooks/{webhook_id}/{webhook_token}
execute_slack_compatible_webhook	send	POST	/webhooks/{webhook_id}/{webhook_token}/slack
execute_github_compatible_webhook	send	POST	/webhooks/{webhook_id}/{webhook_token}/github
crosspost_message	send	POST	/channels/{channel_id}/messages/{message_id}/crosspost
list_messages	read	GET	/channels/{channel_id}/messages
get_message	read	GET	/channels/{channel_id}/messages/{message_id}
update_message	write	PATCH	/channels/{channel_id}/messages/{message_id}
delete_message	delete	DELETE	/channels/{channel_id}/messages/{message_id}
bulk_delete_messages	delete	POST	/channels/{channel_id}/messages/bulk-delete
create_dm	write	POST	/users/@me/channels
get_channel	read	GET	/channels/{channel_id}
update_channel	admin	PATCH	/channels/{channel_id}
delete_channel	delete	DELETE	/channels/{channel_id}
create_channel_invite	write	POST	/channels/{channel_id}/invites
invite_revoke	admin, delete	DELETE	/invites/{code}
create_webhook	admin	POST	/channels/{channel_id}/webhooks
list_channel_webhooks	read	GET	/channels/{channel_id}/webhooks
get_webhook	read	GET	/webhooks/{webhook_id}
update_webhook	admin	PATCH	/webhooks/{webhook_id}
delete_webhook	admin, delete	DELETE	/webhooks/{webhook_id}
get_guild	read	GET	/guilds/{guild_id}
update_guild	admin	PATCH	/guilds/{guild_id}
list_guild_members	read	GET	/guilds/{guild_id}/members
get_guild_member	read	GET	/guilds/{guild_id}/members/{user_id}
delete_guild_member	admin	DELETE	/guilds/{guild_id}/members/{user_id}
ban_user_from_guild	admin	PUT	/guilds/{guild_id}/bans/{user_id}
unban_user_from_guild	admin	DELETE	/guilds/{guild_id}/bans/{user_id}
bulk_ban_users_from_guild	admin	POST	/guilds/{guild_id}/bulk-ban
create_guild_role	admin	POST	/guilds/{guild_id}/roles
delete_guild_role	admin, delete	DELETE	/guilds/{guild_id}/roles/{role_id}
add_guild_member_role	admin	PUT	/guilds/{guild_id}/members/{user_id}/roles/{role_id}
delete_guild_member_role	admin	DELETE	/guilds/{guild_id}/members/{user_id}/roles/{role_id}
get_my_user	read	GET	/users/@me
update_my_user	write	PATCH	/users/@me
list_my_guilds	read	GET	/users/@me/guilds
leave_guild	admin	DELETE	/users/@me/guilds/{guild_id}