Import

The endpoints on this page provide an abstract way of importing data into ClearXP without the need to understand the underlying implementation details. Because ClearXP is a configuration-driven platform, these endpoints are versatile in their use and can be adapted to each organisation's unique data needs.
Take for example, importing an Org Structure and the two use-cases below:
Use Case 1: Import Position Hierarchy
As demonstrated in the documented examples below, by attaching a Position Number to each user profile and linking this to an org structure by id, the system would be able to place the user within the org structure and attach metadata to their profile to control permissions, learning assignments and enhance reporting.
Furthermore, linking this to Job Architecture would enable the platform to be able to automatically recommend content to learner to satisfy the requirements for promotion to the next position in the org hierarchy.
Use Case 2: Import Location Data
Alternatively, the org structure endpoint can be minimally used to attach flat location data to each user's profile. In this case, the parentId isn't required and the id may represent an attribute on the user's profile such as City. In this case, the org data could be used to populate the State and Country for that user.
Again, this location data can assist with configuring permissions, learning assignments and enhance reporting.
Although not essential for ClearXP to operate, importing richer data enables greater platform functionality. AI and Machine Learning algorithms utilised by the platform benefit from clean and complete metadata and will ensure more accurate results.
put
https://{organisation}.clearlrs.com
/api/import/users
Import Users
Example Request Body
[
    {
        "name": "John Smith",
        "attributes": {
            "Email": "[email protected]",
            "Hire Date": "2020-06-01",
            "Position Number": "00002",
            "Position Title": "Senior Sales Representative",
            "Manager Email": "[email protected]"
        }
    }
]
put
https://{organisation}.clearlrs.com
/api/import/organisation
Import Org Structure
Example Request Body
[
    {
        "id": "00002",
        "parentId": "00001",
        "attributes": {
            "Position Number": "00002",
            "Position Title": "Sales Representative",
            "Department": "Sales",
            "State": "VIC",
            "Country": "Australia"
        }
    }
]
put
https://{organisation}.clearlrs.com
/api/import/jobs
Import Job Architecture
Example Request Body
[
    {
        "id": "10001",    
        "name": "Sales Representative",
        "competencies": [
            {
                "Name": "Persuades",
                "Description": "Using compelling arguments to gain the support and commitment of others."
            },
            {
                "Name": "Being Resilient",
                "Description": "Rebounding from setbacks and adversity when facing difficult situations."
            }
        ],
        "attributes": {
            "Job Family": "Sales & Marketing",
        }
    }
]
Clear API Reference - Previous
Notifications
Last modified 1yr ago