award badge to user

Developing

POST

/badges/{id}/award

Request

Path Params

Header Params

Body Params application/json

Example

{
    "userId": "1"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://rai-api.returning.ai/api/v1/badges/b3df14ee-a674-480b-be2a-3f32c9d3a1d9/award' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "1"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "meta": {
        "success": true,
        "message": "Badge has been rewarded successfully",
        "devMessage": "Badge has been rewarded 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.amazonaws.com/apireturningai/tester/1721891103626-d763c952a89131696dd3bdf79fa0108.png"
        }
    ]
}

Modified at 2025-05-22 06:06:42

delete badge

remove badge from user