List user roles

Legacy category: This endpoint is retained for compatibility, historical admin tooling, or test workflows. Do not use it as the default choice for new integrations unless the backend team confirms this exact route is still supported for your community.

What it is for: List user roles.

How to use it: Send a GET request to /roles/{userId} with the documented body, query parameters, headers, or multipart fields. Prefer the newer authenticated /v1/... integration API where available.

Successful response: HTTP 2xx. Older endpoints may return a legacy response envelope or a resource-specific payload rather than the newer { status, message, data } wrapper.

Common error states:

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.

Legacy status:
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.

Source-backed clarification:
These are compatibility endpoints using older server/role terminology. Use them only when maintaining an existing integration. For new public docs and integrations, prefer community/user permission language and scoped API-key permissions.

{ "meta": { "success": true, "message": "User roles fetched successfully", "devMessage": "User roles fetched successfully" }, "body": [ { "_id": "{_id}", "order": 1, "billable": true, "title": "Manager 2", "description": "Role with permissions to moderate the server", "serverPermissions": { "allow_dm": true, "create_invite": true, "kick_members": true, "ban_members": true, "manage_roles": true, "manage_channels": true, "server_administrator": true, "warn_members": true, "suspend_members": true, "broadcast_messages": true, "overwrite_language_settings": true }, "channelPermissions": { "view_message_history": true, "manage_messages": true, "allow_mentions": true, "post_messages": true, "post_analysis": true, "attach_files": true, "delete_messages": true }, "class": "red", "serverId": "{_id}", "createdAt": "2025-04-30T08:48:49.094Z", "updatedAt": "2025-04-30T08:48:49.094Z", "__v": 0 } ] }

Request

Responses