PATCH /v1/presentations/{presentationId}/slides/{slideKey} · API v1 · versioning
PUT the MP3 to the upload target the creation returned, then send its word timings, duration and digest here. The slide starts playing for anyone already watching, and audioProgress on the presentation advances. API-key callers only.
Authentication
Send an API key as Authorization: Bearer bisque_live_…. Keys come from bisque.cloud/setup/keys; see Authentication.
Request
| Parameter | In | Meaning |
|---|---|---|
presentationId | path, required | |
slideKey | path, required | e.g. slide-04, as the creation named it. |
Content-Type: application/json.
Example
curl -X PATCH https://bisque.cloud/v1/presentations/{presentationId}/slides/{slideKey} \
-H "Authorization: Bearer $BISQUE_API_KEY" \
-H "Content-Type: application/json" \
--data @body.json
Response
200: Narration counts after this slide.
Errors:
400: The timings do not match the slide's words.401: Missing or invalid credential.404: No creation is open for this presentation.
Other endpoints
| Page | Call | What it does |
|---|---|---|
| Create a presentation | POST /v1/presentations | Put the slides up now and narrate them one at a time. |
| Get a presentation | GET /v1/presentations/{presentationId} | The open creation, to resume it from a new session. |
| Add slides | PATCH /v1/presentations/{presentationId} | Append sections while the creation is open. |
| Wait for an answer | GET /v1/presentations/{presentationId}/surveys/{surveyId}/response | Hold for the viewer's answer to a question on a slide. |
| Finalize | POST /v1/presentations/{presentationId}:finalize | Claim the version. Slides still without audio stay silent. |
| Read as text | GET /api/presentations/context | Any shared presentation as a transcript. No credential needed. |