Update community bot profile
PUT
/community-bot
What this endpoint does
PUT /community-bot. On https://api.returning.ai that unprefixed path 404s. The mounted path is PUT /v1/community-bot.Quick start
{} is the safe probe.name max length 32. avatar may be null to clear.Authentication and permission
Complete examples
PUT /community-bot is not mounted.PUT /v1/community-bot with {} returns Validation failed detail.body: Request body must be a non-empty object.200 is not documented from a live mutation on this page.Success and readback
Errors and recovery
| Status | When | Recovery |
|---|---|---|
404 | Path without /v1 | Call /v1/community-bot. |
400 empty object | {} | Send name and/or avatar. |
401 | Missing or invalid token | Add a valid community key. |
Retry safety
WARNING
Gotchas
/v1.PUT /v1/appearance, not this path.Next steps
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://adss-production.returning.ai/apis/partner/community-bot' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "server bot edited",
"avatar": "https://d1qp7obm8na1ru.cloudfront.net/57ef33a0-3896-11f1-95a3-399026424a57_appearance.webp"
}'Response Response Example
200 - Example 1
{
"meta": {
"status": "string",
"statusCode": 0
},
"message": "string",
"data": {
"property1": "string",
"property2": "string"
}
}Modified at 2026-08-19 13:45:43