Quick Summary: The training library is your company’s catalogue: courses, videos, documents and sessions, each described by five company-defined reference lists. Assigning an item to a person creates a learning plan in Team Data — the catalogue and the assignment are different resources.
The resources
Five lists, one path
A learning item points at up to five reference entries. All five lists are served under a single parameterised path,/api/v1/learning-reference/{list}, with the same shape and the same operations — learn one, and you have learned all five. Each list is company-defined and ordered, and deleting an entry that is in use is guarded.
Suggestions become items
Anyone who can see the training library may submit a suggestion. The submitter or a global administrator may revise it while it is pending; only a global administrator approves or rejects it.On approval the suggestion becomes a learning item with the same id. A pending or rejected suggestion is never a catalogue item — do not treat a suggestion id as an item id until it is approved.