Page tree
Skip to end of metadata
Go to start of metadata

Award users with points and specify the reason for awarding them with a POST request to the following URL: /gamification/points/award.

Permissions to run the request: Account Owner, Account Administrators, Department Administratorsor users with a custom role able to edit users.

Department Administrators and users with a custom role can award only users belonging to departments they manage and their sub-departments.

Request Headers

Parameter

Description

X-Auth-Account-Url (required)The base URL of the account, e.g. http://myaccount.ispringlearn.com
X-Auth-Email (required)The login of Account Owner, Account AdministratorDepartment Administrator, or a user with a custom role able to edit users.
X-Auth-Password (required)

The password of Account Owner, Account AdministratorDepartment Administrator, a custom role able to edit users.

user_id (required)

The ID of the user whom you want to award with points.

amount (required)

The amount of points to be awarded.

reason (required)

The reason for awarding the points.

Response Codes

Code

Text

Description

200Successful operationThe points have been successfully awarded.
400Bad RequestA request error.
401UnauthorizedAn authorization error.
403Permission deniedThe user doesn't have enough permissions to fulfill the request.

Sample Request

POST /gamification/points/award HTTP/1.1
Host: api-learn.ispringlearn.com
X-Auth-Account-Url: https://myaccount.ispringlearn.com
X-Auth-Email: email@email.com
X-Auth-Password: password
Content-Type: application/xml
Accept: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<awardGamificationPoints>
<userId>3fa85f64-5717-4562-b3fc-2c963f66afa6</userId>
<amount>10</amount>
<reason>string</reason>
</awardGamificationPoints>

Sample Response

HTTP/1.1 200 Successful operation
Connection: close
  • No labels