Skip to content

Class: BotEndpoint ​

Defined in: endpoints/bot.ts:17

Manage server bot identities using a human session with Create bots permission.

Constructors ​

Constructor ​

ts
new BotEndpoint(client): BotEndpoint;

Defined in: endpoints/bot.ts:18

Parameters ​

ParameterType
clientRESTClient

Returns ​

BotEndpoint

Methods ​

checkUsername() ​

ts
checkUsername(
   serverId, 
   username, 
   botId?
): Promise<IServerBotUsernameResponse>;

Defined in: endpoints/bot.ts:37

Whether username is free to be a bot's handle. Pass botId when renaming that bot, so its own handle counts as free.

Parameters ​

ParameterType
serverIdnumber
usernamestring
botId?number

Returns ​

Promise<IServerBotUsernameResponse>


create() ​

ts
create(serverId, input): Promise<IServerBotTokenResponse>;

Defined in: endpoints/bot.ts:24

Parameters ​

ParameterType
serverIdnumber
inputICreateServerBot

Returns ​

Promise<IServerBotTokenResponse>


list() ​

ts
list(serverId): Promise<IServerBotsResponse>;

Defined in: endpoints/bot.ts:20

Parameters ​

ParameterType
serverIdnumber

Returns ​

Promise<IServerBotsResponse>


preview() ​

ts
preview(serverId, input): Promise<IServerBotPreviewResponse>;

Defined in: endpoints/bot.ts:29

Authoritative current grants in channels visible to the approving human.

Parameters ​

ParameterType
serverIdnumber
inputIServerBotPreviewInput

Returns ​

Promise<IServerBotPreviewResponse>


remove() ​

ts
remove(serverId, botId): Promise<IApiResponse>;

Defined in: endpoints/bot.ts:69

Parameters ​

ParameterType
serverIdnumber
botIdnumber

Returns ​

Promise<IApiResponse>


removeAvatar() ​

ts
removeAvatar(serverId, botId): Promise<IServerBotResponse>;

Defined in: endpoints/bot.ts:56

Parameters ​

ParameterType
serverIdnumber
botIdnumber

Returns ​

Promise<IServerBotResponse>


rotateToken() ​

ts
rotateToken(serverId, botId): Promise<IServerBotTokenResponse>;

Defined in: endpoints/bot.ts:65

Invalidates the previous token immediately; the bot's identity is preserved.

Parameters ​

ParameterType
serverIdnumber
botIdnumber

Returns ​

Promise<IServerBotTokenResponse>


update() ​

ts
update(
   serverId, 
   botId, 
   input
): Promise<IServerBotResponse>;

Defined in: endpoints/bot.ts:60

Parameters ​

ParameterType
serverIdnumber
botIdnumber
inputIUpdateServerBot

Returns ​

Promise<IServerBotResponse>


updateProfile() ​

ts
updateProfile(
   serverId, 
   botId, 
   profile
): Promise<IServerBotResponse>;

Defined in: endpoints/bot.ts:44

Change what the bot's profile shows. Fields left out are unchanged; null clears one.

Parameters ​

ParameterType
serverIdnumber
botIdnumber
profileIServerBotProfileUpdate

Returns ​

Promise<IServerBotResponse>


uploadAvatar() ​

ts
uploadAvatar(
   serverId, 
   botId, 
   file, 
   filename
): Promise<IServerBotResponse>;

Defined in: endpoints/bot.ts:48

Parameters ​

ParameterType
serverIdnumber
botIdnumber
fileBlob
filenamestring

Returns ​

Promise<IServerBotResponse>

Released under the GNU Affero General Public License v3.0.