patch
/oauth2/applications/{id}/botUpdate bot profile
Modifies bot profile information such as name, avatar, and status. Changes apply to the bot account associated with this OAuth2 application.
update_bot_profile
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id* | path | SnowflakeType | The ID of the application |
Request body
application/json
json
{
"type": "object",
"properties": {
"username": {
"description": "The username of the bot",
"$ref": "#/components/schemas/UsernameType"
},
"discriminator": {
"description": "The discriminator of the bot",
"$ref": "#/components/schemas/DiscriminatorType"
},
"avatar": {
"description": "The avatar image as base64",
"anyOf": [
{
"$ref": "#/components/schemas/Base64ImageType"
},
{
"type": "null"
}
]
},
"banner": {
"description": "The banner image as base64",
"anyOf": [
{
"$ref": "#/components/schemas/Base64ImageType"
},
{
"type": "null"
}
]
},
"bio": {
"description": "The bio or description of the bot",
"type": [
"string",
"null"
]
},
"bot_flags": {
"$ref": "#/components/schemas/BotFlags"
}
}
}Responses
200
Success
json
{
"type": "object",
"properties": {
"id": {
"description": "The unique identifier of the bot user",
"$ref": "#/components/schemas/SnowflakeStringType"
},
"username": {
"type": "string",
"description": "The username of the bot"
},
"discriminator": {
"type": "string",
"description": "The discriminator of the bot"
},
"avatar": {
"description": "The avatar hash of the bot",
"type": [
"string",
"null"
]
},
"banner": {
"description": "The banner hash of the bot",
"type": [
"string",
"null"
]
},
"bio": {
"description": "The bio or description of the bot",
"type": [
"string",
"null"
]
},
"flags": {
"$ref": "#/components/schemas/BotFlags"
}
},
"required": [
"id",
"username",
"discriminator",
"avatar",
"banner",
"bio",
"flags"
],
"additionalProperties": false
}400
Bad Request - The request was malformed or contained invalid data
json
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Machine-readable error code"
},
"message": {
"type": "string",
"description": "Human-readable error message"
},
"errors": {
"description": "Field-specific validation errors",
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Field path that failed validation"
},
"code": {
"description": "Machine-readable validation error code",
"type": "string"
},
"message": {
"type": "string",
"description": "Human-readable validation error message"
}
},
"required": [
"path",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}401
Unauthorized - Authentication is required or the token is invalid
json
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Machine-readable error code"
},
"message": {
"type": "string",
"description": "Human-readable error message"
},
"errors": {
"description": "Field-specific validation errors",
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Field path that failed validation"
},
"code": {
"description": "Machine-readable validation error code",
"type": "string"
},
"message": {
"type": "string",
"description": "Human-readable validation error message"
}
},
"required": [
"path",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}403
Forbidden - You do not have permission to perform this action
json
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Machine-readable error code"
},
"message": {
"type": "string",
"description": "Human-readable error message"
},
"errors": {
"description": "Field-specific validation errors",
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Field path that failed validation"
},
"code": {
"description": "Machine-readable validation error code",
"type": "string"
},
"message": {
"type": "string",
"description": "Human-readable validation error message"
}
},
"required": [
"path",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}429
Too Many Requests - You are being rate limited
json
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Machine-readable error code"
},
"message": {
"type": "string",
"description": "Human-readable error message"
},
"errors": {
"description": "Field-specific validation errors",
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Field path that failed validation"
},
"code": {
"description": "Machine-readable validation error code",
"type": "string"
},
"message": {
"type": "string",
"description": "Human-readable validation error message"
}
},
"required": [
"path",
"message"
],
"additionalProperties": false
}
},
"retry_after": {
"type": "number",
"description": "Seconds to wait before retrying"
},
"global": {
"type": "boolean",
"description": "Whether this is a global rate limit"
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}500
Internal Server Error - An unexpected error occurred
json
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Machine-readable error code"
},
"message": {
"type": "string",
"description": "Human-readable error message"
},
"errors": {
"description": "Field-specific validation errors",
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Field path that failed validation"
},
"code": {
"description": "Machine-readable validation error code",
"type": "string"
},
"message": {
"type": "string",
"description": "Human-readable validation error message"
}
},
"required": [
"path",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}