Modify Guild#

ORCAcode discord_modify_guild(struct discord *client, u64_snowflake_t guild_id, struct discord_modify_guild_params *params, struct discord_guild *ret)#

Modify a guild’s settings.

Note

Requires the MANAGE_GUILD permission

Note

Fires a Guild Update event

Parameters:

  • client – the client created with discord_init()

  • guild_id – the unique id of the guild to modify

  • params – request parameters

  • ret – if successful, a discord_guild that should be free’d with discord_guild_cleanup()

Returns:

ORCAcode for how the operation went, ORCA_OK means nothing out of the ordinary

struct discord_modify_guild_params#

Methods

  • Initializer:

    • void discord_modify_guild_params_init(struct discord_modify_guild_params *)

  • Cleanup:

    • void discord_modify_guild_params_cleanup(struct discord_modify_guild_params *)

    • void discord_modify_guild_params_list_free(struct discord_modify_guild_params **)

  • JSON Decoder:

    • void discord_modify_guild_params_from_json(char *rbuf, size_t len, struct discord_modify_guild_params *)

    • void discord_modify_guild_params_list_from_json(char *rbuf, size_t len, struct discord_modify_guild_params ***)

  • JSON Encoder:

    • void discord_modify_guild_params_to_json(char *wbuf, size_t len, struct discord_modify_guild_params *)

    • void discord_modify_guild_params_list_to_json(char *wbuf, size_t len, struct discord_modify_guild_params **)

Public Members

char *name#

name of the guild (2-100) characters

char *region#

voice region id

int verification_level#

verification level

int default_message_notifications#

default message notification level

int explicit_content_filter#

explicit content filter level

u64_snowflake_t afk_channel_id#

id for afk channel

int afk_timeout#

afk timeout in seconds

char *icon#

base64 128x1128 image for the guild icon

u64_snowflake_t owner_id#

user id to transfer guild ownership to (must be owner)

char *splash#

base64 16:9 png/jpeg image for the guild splash (when the server has the INVITE_SPLASH feature

char *discovery_splash#

base64 16:9 png/jpeg image for the guild discovery splash (when the server has the DISCOVERABLE feature)

char *banner#

cannot unescape an ill-formed string base64 16:9 png/jpeg image for the guild banner (wh

u64_snowflake_t system_channel_id#

cannot unescape an ill-formed string the id of the channel where guild notices such as welcome

enum discord_system_channel_flags system_channel_flags#

system channel flags

u64_snowflake_t rules_channel_id#

the id of the channel where Community guilds display rules and/or guidelines

u64_snowflake_t public_updates_channel_id#

the id of the channel where admins and moderators of Community guilds receive notices from Discord

char *preferred_locale#

the preferred locale of a Community guild used in server discovery and notices from Discord; defaults to “en-US”

ja_str **features#

array of guild feature strings

char *description#

the description for the guild, if the guild is discoverable