> ## Documentation Index
> Fetch the complete documentation index at: https://help.skillsdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Training Library

> The catalogue of learning — the items that get assigned, the reference lists that describe them, and the workflow for proposing new ones

<Info>
  **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](/api-docs/resources/learning-plan) in [Team Data](/api-docs/concepts/team-data) — the catalogue and the assignment are different resources.
</Info>

## The resources

| Resource                                                               | What it is                                                                                 |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [Learning item](/api-docs/resources/learning-item)                     | A catalogue entry — the course, video, document or session                                 |
| [Learning reference list](/api-docs/resources/learning-reference-list) | The five lists describing an item: learning type, provider, format, audience, course level |
| [Learning suggestion](/api-docs/resources/learning-suggestion)         | A proposed catalogue entry, pending a global administrator's decision                      |

## 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](/api-docs/resources/learning-suggestion). The submitter or a global administrator may revise it while it is pending; only a global administrator approves or rejects it.

<Note>
  On approval the suggestion becomes a [learning item](/api-docs/resources/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.
</Note>

## Two different records of "what someone has done"

Assigning from this library produces a [learning plan](/api-docs/resources/learning-plan). That is a different resource from a [training record](/api-docs/resources/training), which hangs off a person *skill*. They share no shape and are never interchangeable — both live in [Training Data](/api-docs/concepts/team-data).