Update channel
Deprecated
PUT
/channels/{id}
/channels/{id} with the documented body, query parameters, headers, or multipart fields. Prefer the newer authenticated /v1/... integration API where available.{ status, message, data } wrapper.400 invalid request body, query, ObjectId, pagination, file format, or missing required field.401 missing, invalid, expired, or insufficient API key/token.403 key is valid but cannot access this community/channel/user/resource, where supported by the service.404 route or target resource was not found. Several legacy root routes returned 404 on https://api.returning.ai during smoke testing and need backend confirmation before external use.409 duplicate or conflicting state for create/update operations, where applicable.500 unexpected Returning.AI service error.Compatibility endpoint retained for older integrations. Do not use this endpoint for new integrations unless Returning.AI specifically tells you to maintain a legacy flow. Prefer the current
/v1/... endpoint in the matching non-Legacy category when one exists.Request
Path Params
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.returning.ai/channels/67d04e05f090d20ae5342121' \
--header 'x-api-key: <apiKey>' \
--header 'Content-Type: application/json' \
--data '{
"topic": "Chit Chat",
"channelType": "forum"
}'Response Response Example
200 - Success Example
{
"meta": {
"success": true,
"message": "Channel has been updated successfully",
"devMessage": "Channel has been updated successfully"
},
"body": {
"_id": "{_id}",
"topic": "Report",
"permissions": [],
"userId": "1",
"serverId": "{_id}",
"channelType": "open",
"createdAt": "2024-07-25T16:50:17.610Z",
"updatedAt": "2024-07-25T16:53:27.739Z",
"__v": 0
}
}Modified at 2026-05-18 17:03:37