Skip to main content
PUT
/
applications
/
{application_id}
/
guilds
/
{guild_id}
/
commands
cURL
curl --request PUT \
  --url https://discord.com/api/v10/applications/{application_id}/guilds/{guild_id}/commands \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "name": "<string>",
    "name_localizations": {},
    "description": "<string>",
    "description_localizations": {},
    "options": [
      {
        "type": 11,
        "name": "<string>",
        "description": "<string>",
        "name_localizations": {},
        "description_localizations": {},
        "required": true
      }
    ],
    "default_member_permissions": 4503599627370495,
    "dm_permission": true,
    "contexts": [
      123
    ],
    "integration_types": [
      123
    ],
    "handler": "<unknown>",
    "type": "<unknown>",
    "id": "<unknown>"
  }
]
'
[
  {
    "id": "<string>",
    "application_id": "<string>",
    "version": "<string>",
    "default_member_permissions": "<string>",
    "type": 123,
    "name": "<string>",
    "description": "<string>",
    "name_localized": "<string>",
    "name_localizations": {},
    "description_localized": "<string>",
    "description_localizations": {},
    "guild_id": "<string>",
    "dm_permission": true,
    "contexts": [
      123
    ],
    "integration_types": [
      123
    ],
    "options": [
      {
        "type": 11,
        "name": "<string>",
        "description": "<string>",
        "name_localized": "<string>",
        "name_localizations": {},
        "description_localized": "<string>",
        "description_localizations": {},
        "required": true
      }
    ],
    "nsfw": true
  }
]

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

application_id
string<snowflake>
required
guild_id
string<snowflake>
required

Body

application/json
Maximum array length: 110
name
string
required
Required string length: 1 - 32
name_localizations
object
description
string | null
Maximum string length: 100
description_localizations
object
options
object[] | null
Maximum array length: 25
default_member_permissions
integer | null
Required range: 0 <= x <= 9007199254740991
dm_permission
boolean | null
contexts
integer<int32>[] | null
Minimum array length: 1

This command can be used within a Guild.

integration_types
integer<int32>[] | null
Minimum array length: 1

For Guild install.

handler
null | integer<int32>
type

Slash commands; a text-based command that shows up when a user types /

id
null | string<snowflake>

Response

object[] | null

200 response for bulk_set_guild_application_commands

id
string<snowflake>
required
application_id
string<snowflake>
required
version
string<snowflake>
required
default_member_permissions
string | null
required
type
required

Slash commands; a text-based command that shows up when a user types /

name
string
required
description
string
required
name_localized
string
name_localizations
object
description_localized
string
description_localizations
object
guild_id
string<snowflake>
dm_permission
boolean
contexts
integer<int32>[] | null

This command can be used within a Guild.

integration_types
integer<int32>[]

For Guild install.

options
object[]
nsfw
boolean