GET /v1/presentations/{presentationId} · API v1 · versioning
The open creation as it stands, for its owner picking it up from a new agent session: every slide published so far as indexHtml, which slides have narration, the voice and speed they were narrated with, the assets it holds, the owner's answer to every survey so far, and live.revision. Send that revision back as baseRevision on the next append; an append written against an older one is refused with LIVE_REVISION_CONFLICT. Reading changes nothing. 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 GET https://bisque.cloud/v1/presentations/{presentationId} \
-H "Authorization: Bearer $BISQUE_API_KEY"
Response
200: The live creation.
Errors:
401: Missing or invalid credential.403: Another account opened this creation.404: Not a presentation you can change, or not live: finalized or never opened live.409: Another publish superseded this creation.
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. |
| 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. |
| 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. |