AVAILABLE WITH BUSINESS SUBSCRIPTION

Method: withdrawGamificationPoints

Permissions to Run the Request

Account Owner, Account Administrators, Department Administratorsor custom roles

Department Administrators and users with a custom role can deduct points from users belonging to the departments they manage and their sub-departments.

Request Headers

ParameterTypeDescription
token (required)stringAccess token. You can obtain a token by making a request.
userId (required)stringThe ID of the user whose points you want to deduct.
amount (required)stringThe amount of points to be deducted.
reason (required)stringThe reason for deducting points.

Possible Errors

TypeDescription
Permission deniedThe user doesn't have enough permissions to fulfill the request..
Wrong parametersThe request can't be processed as it doesn't include all the necessary parameters or some of the parameters are wrong.

Sample Request

<?xml version="1.0" encoding="utf-8"?>
  <SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                     xmlns="https://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
      <WithdrawGamificationPointsRequest>
        <credentials>
           <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        </credentials>
        <userId>2c180ffc-8841-11e9-b68a-0242c0a85016</userId>
        <amount>80</amount>
        <reason>Hasn't passed the course</reason>
      </WithdrawGamificationPointsRequest>
    </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>
XML

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
	<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
		xmlns:ns1="https://ispringlearn.com/go/services/api/soap">
		<SOAP-ENV:Body>
			<ns1:SuccessResult>
				<ns1:success>true</ns1:success>
			</ns1:SuccessResult>
		</SOAP-ENV:Body>
	</SOAP-ENV:Envelope>
XML