update_lessons
Batch update existing Skilljar lessons with partial changes; omitted fields stay intact. Replace or delete content items deliberately, with confirmation required for full removal.
Instructions
Update one or more existing lessons. This is a BATCH operation.
Each item needs an `id`. This is a PARTIAL update: an attribute you omit is
PRESERVED, not cleared.
`content_items` has THREE meanings and the difference matters:
omitted -> the lesson's content items are left alone
a non-empty list -> they are replaced with what you supply
an EMPTY list -> every content item is DELETED
Because an empty list is what you get from a loop that found nothing, the
destructive case is refused unless you also pass
`confirm_delete_all_content_items=True`.
A lesson's `type` is read-only; to change it, create a new lesson. `order`
collisions with sibling lessons are NOT auto-resolved - a colliding value
succeeds, both lessons keep it, and their display order becomes undefined.
Requires the `lessons:write` OAuth scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lessons | Yes | ||
| confirm_delete_all_content_items | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | ||
| note | Yes | ||
| total | Yes | ||
| failed | Yes | ||
| succeeded | Yes |