POST /v1/presentations/{presentationId}:finalize · API v1 · versioning
Claims the version number and marks the presentation ready. Slides still without audio stay silent and are named in silentSlides. 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 |
Example
curl -X POST https://bisque.cloud/v1/presentations/{presentationId}:finalize \
-H "Authorization: Bearer $BISQUE_API_KEY"
Response
200: Finished; this is the version.
Errors:
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. |
| Update a slide | PATCH /v1/presentations/{presentationId}/slides/{slideKey} | Give one slide its narration after the MP3 is uploaded. |
| Wait for an answer | GET /v1/presentations/{presentationId}/surveys/{surveyId}/response | Hold for the viewer's answer to a question on a slide. |
| Read as text | GET /api/presentations/context | Any shared presentation as a transcript. No credential needed. |