Abilities

Create Presentation

lh-presentations/create-presentation

Creates a new lh_presentation post as a draft. Builds Gutenberg block markup from a structured slide definition array. Cannot publish — use the WordPress editor to publish when ready. Requires publish_posts. Pass site_id to act on another site you belong to.

ParameterTypeRequiredDefaultDescription
titlestringYesThe presentation title.
slidesarray of objectYesArray of slide definitions. Replaces all existing slides when used with update-presentation.
loopbooleanNoLoop the presentation. Defaults to false.
kiosk_modebooleanNoKiosk mode — hides controls, disables keyboard, loops. Defaults to false.
auto_slideintegerNoDeck-level auto-advance in seconds. 0 = manual. Defaults to 0.
task_idintegerNoOptional. The lh-tasks task this call is working on. Pass with claim_token: the call is refused unless you hold that claim, and a successful call renews it.
claim_tokenstringNoOptional. The claim_token from claim-next-task for task_id. Required when task_id is given.
site_idintegerNoOptional. ID of another site in the network to act on; list-my-sites gives the sites you belong to. Permissions are checked on that site. Omit for this site.

Update Presentation

lh-presentations/update-presentation Destructive Idempotent

Updates an existing lh_presentation. Replaces all of its slides; deck settings that are passed are updated and those left out are kept. Never changes post status — use the WordPress editor to publish. The caller must also be able to edit that presentation. Requires publish_posts. Pass site_id to act on another site you belong to.

ParameterTypeRequiredDefaultDescription
post_idintegerYesID of the lh_presentation post to update.
titlestringNoNew title. Optional — omit to keep existing title.
slidesarray of objectYesArray of slide definitions. Replaces all existing slides when used with update-presentation.
loopbooleanNoLoop the presentation. Defaults to false.
kiosk_modebooleanNoKiosk mode — hides controls, disables keyboard, loops. Defaults to false.
auto_slideintegerNoDeck-level auto-advance in seconds. 0 = manual. Defaults to 0.
task_idintegerNoOptional. The lh-tasks task this call is working on. Pass with claim_token: the call is refused unless you hold that claim, and a successful call renews it.
claim_tokenstringNoOptional. The claim_token from claim-next-task for task_id. Required when task_id is given.
site_idintegerNoOptional. ID of another site in the network to act on; list-my-sites gives the sites you belong to. Permissions are checked on that site. Omit for this site.