Actors
List Actors
GET
https://{organisation}.clearlrs.com/api/actors
Retrieves a list of all actors in the system.
Insert/Update Agent
PUT
https://{organisation}.clearlrs.com/api/actors/agents
Updates any agent with a matching account or unique identifier in the system, otherwise inserts a new agent. The request body must be a valid xAPI actor.
Headers
Request Body
Search Actors
POST
https://{organisation}.clearlrs.com/api/actors/search
Advanced search for all actors in the system. The results of this search will include both Agents and Groups unless the criteria object specifies otherwise.
Query Parameters
Request Body
Search Criteria
The actor search endpoint allows for defining a complex search criteria. The most basic request body might look like the following:
A more complex example can include nested conditions:
List Attributes
GET
https://{organisation}.clearlrs.com/api/actors/attributes
Lists any recorded attributes for Actors in the system along with a JSON Schema of what types each attribute is, if relevant.
Get Completion Records
GET
https://{organisation}.clearlrs.com/api/actors/completions
Pulls all completion records for the current actor, filterable by status as well as activity. When an activityId
and expand=hierarchy
is set, then each result will include a recursive children
field containing the results for each child in the hierarchy.
Query Parameters
Headers
Last updated