POST /api/:space/account/reward-types

Description:

Create a new reward type.

Resource URL:

https://<apphost>.competitionlabs.com/api/<your-space-name>/account/reward-types

Request headers

Key	Value	Required
X-API-KEY	Your unique API key	Yes
Content-Type	application/json	Yes

Request URL parameters

Parameter	Type	Required	Description
space	String	Yes	This is the space name which is linked to the account

Post body parameters

Parameter	Type	Required	Description
name	String	Yes	The name of a reward type
key	String	Yes	The reference to the reward type in your system
description	String	Optional	The description of a reward type
system	Boolean	Optional	Default false. True states that the reward type can be deleted
unitOfMeasureType	String	Yes	A type of unit of measure, eg. Currency, Mass, Time and etc.
metadata	Array [Object]	Optional	A list of MetaData. An object of key value pair (KVP):
			Parameter	Type	Required	Description
			key	String	Yes	Is a unique identifier
			value	Array [String]	Yes	The data that is identified.

EXAMPLE

Request

curl
--header "X-API-KEY: <your-api-key>"
--header "Content-Type: application/json"
--request POST https://app.competitionlabs.com/api/<your-space-name>/unitofmeasure
-d '{ "name": "test", "key": "test", "description": "test", "system": "false", "unitOfMeasureType": "Distance", "metadata": []}'

Response

{
    "data": [
        {
            "jsonClass": "RewardType",
            "name": "test",
            "key": "test",
            "description": "test",
            "accountId": "0sn4DmUBkPH_lz9Ggasd",
            "system": false,
            "unitOfMeasureType": "Distance",
            "metadata": [],
            "created": "2020-08-10T09:22:54.130+0000",
            "id": "0iyu13MBDp41zK05CmQy"
        }
    ]
}

ERROR CODES

Code	HTTP Status	Description	Example
1021	409	Duplicate reward type found	Error Response 409 Expand source { "errors": [ { "message": "Duplicate record found", "code": 2026, "status": 409 } ] }
1001	400	`Reward Type` parameter was excluded; `Reward Type` parameter was incorrect; `Multiplier` parameter was excluded; `Name` parameter was excluded; `Key` parameter was excluded;	Error Response 400 Expand source { "errors": [ { "message": "Malformed JSON body.", "code": 1001, "status": 400 } ] }
	404	Adding anything extra to the `Resource URL`	Error Response 400 Expand source { "status": 404 }
1002	404	The parameter `Name` can not be empty; The parameter `Key` can not be empty;	Error Response 400 Expand source { "errors": [ { "message": "Please enter a name for the unit of measure.", "code": 1002, "status": 404 } ] } Error Response 400 Expand source { "errors": [ { "message": "Please enter a key for the unit of measure.", "code": 1002, "status": 404 } ] }