Overview
The /1/learner endpoint provides for the creation of new learners.
Endpoint Details
Required Headers
| Key | Value | Example |
|---|---|---|
| Accept | application/json | |
| Authorization | Bearer <your token> | Bearer wV1MLk5+sFzioJw/3M5r9A== |
| Content-Type | application/json | |
| X-UserId | <the user id> | The DMTD-supplied identifier that identifies the owner of the learner |
| X-UserCode | <the user code> | A REST-client-supplied identifier that identifies the owner of the learner |
Fields
| Field | Type | Optional | Description |
|---|---|---|---|
| code | String | Optional | A unique code that correlates the student to an external database and/or obfuscates the student's name (maximum length 191 chars); correlates to X-LearnerCode |
| color | String | Optional | A CSS color to associate with the client (e.g. #ffffff) |
| dateOfBirth | Date | Required | The date of birth for the learner |
| firstName | String | Optional | |
| lastName | String | Optional | |
| gender | Integer | Optional | 1 = male, 2 = female |
| isActive | Bool | Optional | A flag that indicates whether the learner is being actively assesses (default = true) |
Example
curl -X POST \
-H 'Authorization: Bearer wV1MLk5+sFzioJw/3M5r9A==' \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-UserId: 1" \
-d '{ "code": "Code: 1234", "color": "#ffff", "dateOfBirth": "2014-01-01", "firstName": "Fred", "gender": 1, "isActive": true, "lastName": "value" }' \
http://data-sandbox.datamtd.com/1/learner
Response
{
"gender": 1,
"color": "#ffff",
"firstName": "Fred",
"id": 570,
"code": "Code: 1234",
"dateOfBirth": "2014-01-01T00:00:00Z",
"isActive": true,
"organizationId": 1,
"updatedAt": "2019-06-13T05:16:09Z",
"createdAt": "2019-06-13T05:16:09Z",
"lastName": "value"
}