---
title: "GET /v1/presentations/{presentationId}"
description: "The open creation, to resume it from a new session."
canonical: https://bisque.cloud/docs/api/presentations/get
---

# Get a presentation

The open creation, to resume it from a new session.

Page: https://bisque.cloud/docs/api/presentations/get

`GET /v1/presentations/{presentationId}` · API v1 · [versioning](/docs/api/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](https://bisque.cloud/setup/keys); see [Authentication](/docs/api/authentication).

## Request

| Parameter | In | Meaning |
| --- | --- | --- |
| `presentationId` | path, required |  |

## Example

```bash
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](/docs/api/presentations/create) | `POST /v1/presentations` | Put the slides up now and narrate them one at a time. |
| [Add slides](/docs/api/presentations/add-slides) | `PATCH /v1/presentations/{presentationId}` | Append sections while the creation is open. |
| [Update a slide](/docs/api/presentations/update-slide) | `PATCH /v1/presentations/{presentationId}/slides/{slideKey}` | Give one slide its narration after the MP3 is uploaded. |
| [Wait for an answer](/docs/api/presentations/wait-for-answer) | `GET /v1/presentations/{presentationId}/surveys/{surveyId}/response` | Hold for the viewer's answer to a question on a slide. |
| [Finalize](/docs/api/presentations/finalize) | `POST /v1/presentations/{presentationId}:finalize` | Claim the version. Slides still without audio stay silent. |
| [Read as text](/docs/api/presentations/read-as-text) | `GET /api/presentations/context` | Any shared presentation as a transcript. No credential needed. |