Skip to content

Remove create guild endpoints #7715

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.

Sign up for GitHub

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

Merged
merged 1 commit into from
Jul 28, 2025
Merged

Remove create guild endpoints #7715

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 0 additions & 16 deletions docs/resources/guild-template.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -104,22 +104,6 @@ Represents a code that when used, creates a guild based on a snapshot of an exis

Returns a [guild template](/docs/resources/guild-template#guild-template-object) object for the given code.

## Create Guild from Guild Template
<Route method="POST">/guilds/templates/[\{template.code\}](/docs/resources/guild-template#guild-template-object)</Route>

Create a new guild based on a template. Returns a [guild](/docs/resources/guild#guild-object) object on success. Fires a [Guild Create](/docs/events/gateway-events#guild-create) Gateway event.

:::warn
This endpoint can be used only by bots in less than 10 guilds.
:::

###### JSON Params

| Field | Type | Description |
|-------|------------------------------------------|-----------------------------------------|
| name | string | name of the guild (2-100 characters) |
| icon? | [image data](/docs/reference#image-data) | base64 128x128 image for the guild icon |

## Get Guild Templates
<Route method="GET">/guilds/[\{guild.id\}](/docs/resources/guild#guild-object)/templates</Route>

Expand Down
71 changes: 0 additions & 71 deletions docs/resources/guild.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -699,77 +699,6 @@ We are making significant changes to the Membership Screening API specifically r
}
```

## Create Guild
<Route method="POST">/guilds</Route>

Create a new guild. Returns a [guild](/docs/resources/guild#guild-object) object on success. Fires a [Guild Create](/docs/events/gateway-events#guild-create) Gateway event.

:::warn
This endpoint can be used only by bots in less than 10 guilds.
:::

###### JSON Params

| Field | Type | Description |
|--------------------------------|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|
| name | string | name of the guild (2-100 characters) |
| region? | ?string | [voice region](/docs/resources/voice#voice-region-object) id (deprecated) |
| icon? | [image data](/docs/reference#image-data) | base64 128x128 image for the guild icon |
| verification_level? | integer | [verification level](/docs/resources/guild#guild-object-verification-level) |
| default_message_notifications? | integer | default [message notification level](/docs/resources/guild#guild-object-default-message-notification-level) |
| explicit_content_filter? | integer | [explicit content filter level](/docs/resources/guild#guild-object-explicit-content-filter-level) |
| roles? | array of [role](/docs/topics/permissions#role-object) objects | new guild roles |
| channels? | array of partial [channel](/docs/resources/channel#channel-object) objects | new guild's channels |
| afk_channel_id? | snowflake | id for afk channel |
| afk_timeout? | integer | afk timeout in seconds, can be set to: 60, 300, 900, 1800, 3600 |
| system_channel_id? | snowflake | the id of the channel where guild notices such as welcome messages and boost events are posted |
| system_channel_flags? | integer | [system channel flags](/docs/resources/guild#guild-object-system-channel-flags) |

:::warn
When using the `roles` parameter, the first member of the array is used to change properties of the guild's `@everyone` role. If you are trying to bootstrap a guild with additional roles, keep this in mind.
:::

:::info
When using the `roles` parameter, the required `id` field within each role object is an integer placeholder, and will be replaced by the API upon consumption. Its purpose is to allow you to [overwrite](/docs/resources/channel#overwrite-object) a role's permissions in a channel when also passing in channels with the channels array.
:::

:::warn
When using the `channels` parameter, the `position` field is ignored, and none of the default channels are created.
:::

:::info
When using the `channels` parameter, the `id` field within each channel object may be set to an integer placeholder, and will be replaced by the API upon consumption. Its purpose is to allow you to create `GUILD_CATEGORY` channels by setting the `parent_id` field on any children to the category's `id` field. Category channels must be listed before any children.
:::

:::warn
The `region` field is deprecated and is replaced by [channel.rtc_region](/docs/resources/channel#channel-object-channel-structure).
:::

###### Example Partial Channel Object

```json
{
"name": "naming-things-is-hard",
"type": 0
}
```

###### Example Category Channel

```json
{
"name": "my-category",
"type": 4,
"id": 1
}
{
"name": "naming-things-is-hard",
"type": 0,
"id": 2,
"parent_id": 1
}
```

## Get Guild
<Route method="GET">/guilds/[\{guild.id\}](/docs/resources/guild#guild-object)</Route>

Expand Down