Skip to main content
PUT
Update Bot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required
Pattern: ^[0-9]{1,19}$

Body

application/json
display_name
string

New display name.

Required string length: 1 - 50
dm_permission
enum<string>

Who may send the bot Direct Messages: everyone, or premium for verified senders only. Premium isn't meant for org-only bots, since everyone in an org-only bot's developer account should be able to message it, verified or not; requesting premium for one may be refused with a 400. The no_one value is deprecated and kept only so bots that already use it can keep it; choosing it for any other bot may be refused with a 400.

Available options:
everyone,
premium,
no_one
handle
string

New handle (X screen name): 5-15 characters, letters, numbers, or underscores.

Required string length: 5 - 15
Pattern: ^[A-Za-z0-9_]{5,15}$

Response

The request has succeeded.

data
object
errors
object[]