Bots · Developer account
updateBot
Update a bot's profile
This method authenticates with your developer account. The easiest way to call it is the dashboard, which signs the request for you. Direct calls need a dashboard session cookie.
Partial update of name/description/avatar_url. At least one field must be supplied. Username cannot be changed.
Request
curl https://api.sprintelex.com/updateBot \
# authenticated with your dashboard session \
-H "Content-Type: application/json" \
-d '{"bot_id":"<bot-id>"}'Parameters
| Name | Type | Required | Rules |
|---|---|---|---|
| bot_id | string | Yes | - |
| name | string | No | trimmed; 1-64 characters when provided |
| description | string | No | trimmed; at most 512 characters when provided |
| avatar_url | string | No | https URL; empty string clears it (stored as null) |
Response
{ ok: true, result: { bot: { id, name, username, avatar_url, description, created_at } } }Rate limit: none in code
Errors
| Status | Error | When |
|---|---|---|
| 400 | bot_id is required | missing bot_id |
| 400 | name must be 1-64 characters | name empty or longer than 64 |
| 400 | description must be at most 512 characters | description longer than 512 |
| 400 | avatar_url must be an https URL | avatar_url not https |
| 400 | nothing to update | no updatable fields supplied |
| 404 | bot not found | no such bot, not owned by caller, or deleted |