find_learner
Read-onlyIdempotent
Identify a learner by exact email to get the ID needed for progress tools, along with registration count, completion count, and latest activity across the organization.
Instructions
Look up a learner by email, and get the id the progress tools need.
Returns the learner's id plus lifetime counts v2 does not carry:
`registration_count`, `completion_count` and `latest_activity` across the whole
organization.
The id returned works in BOTH APIs - the same value identifies this learner to
v2's `get_student` and to `list_learner_progress`. Observed rather than
documented, so worth re-checking if Skilljar ever changes its id scheme.
Email match is exact, and an unknown address returns an empty list rather than
an error - so an empty result does not prove the address is wrong.
`total` is v1's own count of matches. v2 never provides a total for anything.
Requires `CSA_SKILLJAR_V1_API_KEY`, a separate credential from the v2 client.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| total | No | ||
| learners | Yes |