-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Adds docs for Onboarding updates and new mode field #6101
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
a27d06d
to
42336a7
Compare
@@ -1272,6 +1280,19 @@ Modify the guild's [Welcome Screen](#DOCS_RESOURCES_GUILD/welcome-screen-object) | |||
|
|||
Returns the [Onboarding](#DOCS_RESOURCES_GUILD/guild-onboarding-object) object for the guild. | |||
|
|||
## Modify Guild Onboarding % PUT /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/onboarding |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This seems to allow the X-Audit-Log-Reason
header
| prompts | array of [onboarding prompt](#DOCS_RESOURCES_GUILD/guild-onboarding-object-onboarding-prompt-structure) objects | Prompts shown during onboarding and in customize community | | ||
| default_channel_ids | array of snowflakes | Channel IDs that members get opted into automatically | | ||
| enabled | boolean | Whether onboarding is enabled in the guild | | ||
| mode | [onboarding mode](#DOCS_RESOURCES_GUILD/guild-onboarding-object-onboarding-mode) | Current mode of onboarding | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could you add a note that all params are optional?
|
||
| Field | Type | Description | | ||
| ------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | ||
| prompts | array of [onboarding prompt](#DOCS_RESOURCES_GUILD/guild-onboarding-object-onboarding-prompt-structure) objects | Prompts shown during onboarding and in customize community | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the Onboarding Prompt Structure contains an id
, is it required to be included?
Suggestion: add the following error code to | 350001 | Cannot update onboarding while below requirements | Occurs when one of the requirements (number of default channels for example) isn't met anymore and a bot/user tries to edit any part of onboarding |
Co-authored-by: shay <swdewael@gmail.com>
Thanks |
Thanks 😀😊 |
The DSL looks like this: val onboarding = guild.editOnboarding { enabled = true mode = OnboardingMode.Advanced defaultChannelId(channelId1) defaultChannelId(channelId2) defaultChannelId(channelId3) defaultChannelId(channelId4) defaultChannelId(channelId5) defaultChannelId(channelId6) defaultChannelId(channelId7) prompt( OnboardingPromptType.MultipleChoice, title = "prompt title", singleSelect = false, required = false, inOnboarding = true, ) { option(title = "option 1 title") { channelIds += someChannelId description = "option 1 description" } option(title = "option 2 title") { roleIds += someRoleId } } } println(onboarding) See discord/discord-api-docs#6101
The DSL looks like this: val onboarding = guild.editOnboarding { enabled = true mode = OnboardingMode.Advanced defaultChannelId(channelId1) defaultChannelId(channelId2) defaultChannelId(channelId3) defaultChannelId(channelId4) defaultChannelId(channelId5) defaultChannelId(channelId6) defaultChannelId(channelId7) prompt( OnboardingPromptType.MultipleChoice, title = "prompt title", singleSelect = false, required = false, inOnboarding = true, ) { option(title = "option 1 title") { channelIds += someChannelId description = "option 1 description" } option(title = "option 2 title") { roleIds += someRoleId } } } println(onboarding) See discord/discord-api-docs#6101
The DSL looks like this: val onboarding = guild.editOnboarding { enabled = true mode = OnboardingMode.Advanced defaultChannelId(channelId1) defaultChannelId(channelId2) defaultChannelId(channelId3) defaultChannelId(channelId4) defaultChannelId(channelId5) defaultChannelId(channelId6) defaultChannelId(channelId7) prompt( OnboardingPromptType.MultipleChoice, title = "prompt title", singleSelect = false, required = false, inOnboarding = true, ) { option(title = "option 1 title") { channelIds += someChannelId description = "option 1 description" } option(title = "option 2 title") { roleIds += someRoleId } } } println(onboarding) See discord/discord-api-docs#6101
* Adds docs for Onboarding updates and new mode field * Add constraints and info * Update docs/resources/Guild.md Co-authored-by: shay <swdewael@gmail.com> * add error codes for onboarding --------- Co-authored-by: shay <swdewael@gmail.com>
No description provided.