1. Gamification
Returning.AI
  • Getting Started
  • Authentication
    • Secure Auth
      GET
    • register
      POST
    • verify email
      POST
    • login
      POST
  • Users
    • Get user
      GET
    • Get Users with Filters
      POST
    • Create New User
      POST
    • Get User Data
      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
    • get my servers
    • update server
  • Channels
    • channel list of server
    • get channels list
    • create new channel
    • update channel
    • delete channel
    • Get Channels List
  • Messaging
    • Get Messages
    • Send Message
    • Reply Message
    • React Message
    • Upload Image
  • User Data
    • Get All User Fields
    • Get Specific User Field
    • Create Custom 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
      GET
    • create new badge
      POST
    • update badge
      PUT
    • delete badge
      DELETE
    • remove badge from user
      POST
    • award badge to user
      POST
    • Get Tier Info
      GET
    • Get User Gamification History
      POST
    • Get User Gamification Logs
      POST
  • Streaks & Mini Games
    • Get Streak Logs
  • 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
  • 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
    • Premium Currency Bulk Update
  • Application API
    • Community Users
      • Get community users
      • Get user
  • Integration API
  • Channels
    • Iframe
  • 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
  1. Gamification

update badge

Developing
PUT
/badges/{id}

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://sgtr-api.returning.ai/badges/84845081-98fd-46f3-96aa-1032174e58a5' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "It'\''s title",
    "action": "custom",
    "quantity": 100,
    "image": "",
    "description": "This is description",
    "darkImage": "",
    "lightImage": "",
    "enabledDarkAndLight": true,
    "award": true,
    "awardCurrency": true,
    "awardXpQuantity": 100,
    "awardCurrencyQuantity": 100,
    "attachRequired": true
}'
Response Response Example
{
    "meta": {
        "success": true,
        "message": "Badge has been updated successfully",
        "devMessage": "Badge has been updated successfully"
    },
    "body": {
        "title": "Major",
        "action": "custom",
        "quantity": "3",
        "description": "One trade on a live account that makes 30%. Send account statement to #Tickmill-badge channel",
        "attachRequired": "true",
        "awarded": "true",
        "id": "{_id}",
        "image": "https://chartsnapshot.s3.us-east-2.amazonaws.com/apireturningai/tester/1721927206522-d763c952a89131696dd3bdf79fa0108.png"
    }
}
Modified at 2026-04-07 08:41:23
Previous
create new badge
Next
delete badge
Built with