Returning.AI
    • Getting Started
    • Authentication
      • Secure Auth
        GET
      • register
        POST
      • verify email
        POST
      • login
        POST
      • Secure Auth
        GET
    • Users
      • Get Users with Filters
        POST
      • Create New User
        POST
      • Get User Data Copy
        POST
      • Manage User Account
        POST
      • Get User Gamification Stats
        POST
      • Get all mini game logs by user email
        POST
      • Get user's current Mini Games and Streak stats
        POST
    • Roles & Permissions
      • role list of server
        GET
      • create new role
        POST
      • update role
        PUT
      • delete role
        DELETE
      • get role list of user on a server
        GET
      • add role to a user on a server
        POST
      • remove role from a user on a server
        POST
    • Servers
      • create new server
        POST
      • get my servers
        GET
      • update server
        PUT
    • Channels
    • Messaging
      • Get Messages
        GET
      • Send Message
        POST
      • Reply Message
        POST
      • React Message
        POST
      • Upload Image
        POST
    • User Data
      • Get Specific User Field
      • Update Custom User Field
      • Delete Custom User Field
      • Get all user field histories in a community
      • Get user field histories for a specific field
      • Get user field histories for a specific user
      • Get user field histories of specific user field and user
      • Create user field history for specific user
    • Gamification
      • get badges list
      • create new badge
      • update badge
      • delete badge
      • remove badge from user
      • award badge to user
      • Get Tier Info
      • Get User Gamification History
      • Get User Gamification Logs
    • Streaks & Mini Games
      • Get Streak Logs
      • Edit wheel information for each user
      • Edit wheel information for each user
    • Rewards & Redemptions
      • Update redemption transaction status
      • Get all redemption transactions by user email
      • Get All Redemption Statuses
      • Get Redemption Status by ID
      • Get all redemption transactions by Community
      • Create Redemption Status
      • Get redemption transaction status history
    • Chart Analysis
      • Create Analysis
      • Get Analysis
      • Update Analysis
      • Delete Analysis
      • List Analyses
      • Append Drawings
    • Bulk Operations
      • Bulk Import
      • Get All Bulk Update
      • Check Bulk Update Status
      • Check Bulk Update Details
      • Bulk Update Copy
      • Premium Currency Bulk Update
    • Application API
      • Community Users
        • Get community users
        • Get user
    • Integration API
    • Channels
      • Iframe
      • channel list of server
      • get channels list
      • create new channel
      • update channel
      • delete channel
      • Get Channels List
    • Events
      • Outgoing webhooks
        • Encryption
        • User Joins Server
        • User Visits server
        • New Message Posted Anywhere
        • New Message Posted To channel
        • Purchased Store Item
      • Incoming webhooks
        • API Keys & Encryption
        • Send message into channels
        • Update Custom User Fields
        • Update In-game currency
    • Widgets
      • Authenticated Widgets
      • Public widgets
    • Features
    • Community Analytics
      • Get Loyalty Overview
    • Personalization Service
      • Appearance
        • Theme Color Form Update
        • Server Bot
        • Meta
      • Appearance
        • Theme Color Form Update
        • Server Bot
        • Meta
        • Name & Uri
    • Partner API
      • Leaderboards
        • List leaderboards with pagination
        • Create a new leaderboard
        • Get a single leaderboard by ID
        • Update an existing leaderboard
        • Delete a leaderboard
      • Purchase History
        • Update purchase history redemption instructions
    • Schemas
      • Sample Schemas
      • Schemas
      • Outgoing webhooks
      • Analysis
      • Pet
      • ValidationError
      • Purchased store item
      • UpdateAnalysisRequest
      • Category
      • NotFoundError
      • New message posted to channel
      • AppendDrawingsRequest
      • Tag
      • InternalServerError
      • User visits server
      • CreateAnalysisResponse
      • NotImplementedError
      • User join server
      • GetAnalysisResponse
      • CreateUserFieldHistoryResponse
      • ErrorResponse
      • UpdateAnalysisResponse
      • CreateUserFieldHistorySuccessResponse
      • AppendDrawingsResponse
      • UserFieldHistoryItem
      • AnalysisMetadata
      • GetUserFieldHistoriesResponse
      • Expiry
      • UserFieldHistoriesValidationError
      • Levels
      • UserFieldHistoriesMetaWithValidation
      • LevelEntry
      • UserFieldHistoriesMetaWithPagination
      • Drawing
      • GetUserFieldHistoriesSuccessResponse
      • HorizontalLineDrawing
      • CreateUserFieldResponse
      • LineDrawing
      • CreateUserFieldSuccessResponse
      • RectangleDrawing
      • DeleteUserFieldResponse
      • ParallelDrawing
      • DeleteUserFieldSuccessResponse
      • FibonacciRetracementDrawing
      • UserFieldCreator
      • Coordinate
      • GetUserFieldResponse
      • DrawingStyle
      • GetUserFieldSuccessResponse
      • AnalysisDetail
      • ValidationErrorItem
      • AnalysisSummary
      • GetUserFieldsMetaResponse
      • CreateAnalysisRequest
      • CreatorInfo
      • ListAnalysesResponse
      • UserFieldResponse
      • GetUserFieldsSuccessResponse
      • UpdateUserFieldResponse
      • UpdateUserFieldPayload
      • UpdateUserFieldSuccessResponse
      • MetaResponse
      • GetUserResponse
      • GetUserSuccessResponse

    Getting Started

    Almost all endpoints will require authentication to ensure secure access.

    Supported Methods#

    1.
    API Key : Used for system API endpoints. Include an X-API-Key header with the key.
    Key is found in community settings > Login Management > API key
    image.png
    Each community has only one such key, which grants full permissions for all system endpoints.
    2.
    Bearer token: Used for Application and Intergration API endpoints. Include an Authorization header with the format Bearer YOUR_TOKEN.
    Token is found in community settings > Integration > API key
    image.png
    API keys must be created by admins. Each key can have unique permissions and an expiration date.
    Individual endpoints require specific permissions, which are documented in their respective sections.
    3.
    User API key: Used for User Api endpoints.
    Include an Authorization header with the format Bearer YOUR_TOKEN.
    Token is found in user prefernces > API keys

    Error Handling#

    401: Insufficient permissions for the requested action/ Invalid token.
    Modified at 2026-04-09 03:35:17
    Next
    Secure Auth
    Built with