Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The /1/learner endpoint provides for the creation of new learners.

...

Info
titleRequired Headers


KeyValueExample
User-Agent<company identifier>The exact value here is not important, but it should include something to identify your company
Acceptapplication/json
AuthorizationBearer <your token>Bearer wV1MLk5+sFzioJw/3M5r9A==
X-UserId<the user id>The id of the user to view the learners for (See REST API Guide and /1/user - POST)

NOTE: This value must be provided by iFrame customers and only one of X-UserId or X-UserCode should be specified.  All other customers must omit this header field.
X-UserCode<the user code>

The code of the user to view the learners for (See REST API Guide and /1/user - POST)

NOTE: This value must be provided by iFrame customers and only one of X-UserId or X-UserCode should be specified.  All other customers must omit this header field.

Content-Typeapplication/json


...

Info
titleFields


FieldTypeOptionalDescription
codeStringOptionalA 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
colorStringOptionalA CSS color to associate with the client (e.g. #ffffff)
dateOfBirthDateRequiredThe date of birth for the learner
firstNameStringOptional
lastNameStringOptional
genderIntegerOptional1 = male, 2 = female
isActiveBoolOptionalA flag that indicates whether the learner is being actively assessed (default = true)


...

Info
titleResponse
{
    "gender": 1,
    "color": "#ffff",
    "firstName": "Fred",
    "id": 570,
    "code": "Code: 1234",
    "dateOfBirth": "2014-01-01T00:00:00Z",
    "isActive": true1,
    "organizationId": 1,
    "updatedAt": "2019-06-13T05:16:09Z",
    "createdAt": "2019-06-13T05:16:09Z",
    "lastName": "value"
}

...