Create server
Deprecated
POST
/servers
/servers 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
Body Params multipart/form-data
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.returning.ai/servers' \
--header 'Authorization: Bearer <token>' \
--form 'name="Vise Neg"'Response Response Example
201 - Success
{
"meta": {
"success": true,
"message": "Server has been created successfully",
"devMessage": "Server has been created successfully"
},
"body": {
"name": "Galaxy Food And Drink",
"image": "https://chartsnapshot.s3.amazonaws.com/apireturningai/tester/1721923616255-d763c952a89131696dd3bdf79fa0108.png",
"owner": {
"id": "2"
},
"_id": "{_id}",
"__v": 0,
"id": "{_id}"
}
}Modified at 2026-05-18 17:03:37