# Bisque API API

**Canonical:** https://apis.io/apis/bisque-cloud/bisque-api-api/  
**Provider:** Bisque — https://apis.io/providers/bisque-cloud/  
**Base URL:** https://bisque.today  
**Documentation:** https://bisque.cloud/changelog

Bisque API API is one of 2 APIs that [Bisque](https://apis.io/providers/bisque-cloud/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Bisque turns an HTML file an agent wrote into a narrated presentation on a shareable watch link (`/p/{handle}/{slug}`), and lets an agent read any shared presentation back as a transcript.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/presentations/spec` | The html-presentation/v1 authoring format |
| GET | `/api/presentations/spec/{part}` | One module of the authoring format |
| GET | `/api/presentations/context` | Read a presentation as text |
| POST | `/api/presentations/context` | Read up to 20 presentations in one request |
| POST | `/api/presentations/context/batch` | Read up to 20 presentations in one request |
| GET | `/api/oembed` | oEmbed for a watch URL |
| GET | `/api/presentations` | Your presentations, newest first, cursor-paginated |
| POST | `/api/presentations/create` | Publish a presentation from HTML |
| GET | `/api/presentations/status` | Narration and publish progress |
| POST | `/v1/presentations` | Create a presentation and put its slides up now |
| GET | `/v1/presentations/{presentationId}` | Read a live creation to resume it |
| PATCH | `/v1/presentations/{presentationId}` | Add slides to a live creation |
| GET | `/v1/presentations/{presentationId}/surveys/{surveyId}/response` | Wait for the owner's answer to a survey |
| PATCH | `/v1/presentations/{presentationId}/slides/{slideKey}` | Give one slide its narration |
| POST | `/v1/presentations/{presentationId}:finalize` | Finish the creation |
| POST | `/api/presentations/publish-narrated` | Publish with audio you synthesized locally (deprecated) |
| POST | `/mcp` | Presentations MCP server |
| POST | `/ask` | Ask a question (NLWeb 0.55) |
| GET | `/ask` | Ask a question (NLWeb 0.55), GET form |
| POST | `/docs/mcp` | Documentation MCP server |
| POST | `/oauth/register` | Dynamic client registration (RFC 7591) |
| POST | `/oauth/token` | Token endpoint (authorization_code + PKCE, refresh_token) |
| POST | `/oauth/revoke` | Revoke a token (RFC 7009) |
| GET | `/oauth/userinfo` | OIDC-style userinfo for openid-scoped tokens |
| GET | `/.well-known/oauth-authorization-server` | RFC 8414 authorization-server metadata, with the auth.md `agent_auth` block |
| GET | `/.well-known/oauth-protected-resource` | RFC 9728 protected-resource metadata for the MCP server |
| GET | `/.well-known/mcp.json` | MCP manifest: the presentations server's address, transport, tools, and the widget each tool renders |
| GET | `/.well-known/did.json` | DID document for did:web:bisque.today — the identity the ARD catalog's trustManifest cites |
| GET | `/.well-known/http-message-signatures-directory` | Web Bot Auth key directory (Ed25519 JWKs) for requests Bisque's agents sign |
| GET | `/auth.md` | How an agent obtains, uses, and revokes a credential |
| GET | `/llms.txt` | What this site is, when to use it, and where the docs are |
| GET | `/api/v1/presentations/spec` | The html-presentation/v1 authoring format |
| GET | `/api/v1/presentations/spec/{part}` | One module of the authoring format |
| GET | `/api/v1/presentations/context` | Read a presentation as text |
| POST | `/api/v1/presentations/context` | Read up to 20 presentations in one request |
| POST | `/api/v1/presentations/context/batch` | Read up to 20 presentations in one request |
| GET | `/api/v1/presentations` | Your presentations, newest first, cursor-paginated |
| POST | `/api/v1/presentations/create` | Publish a presentation from HTML |
| GET | `/api/v1/presentations/status` | Narration and publish progress |
| POST | `/api/v1/presentations/publish-narrated` | Publish with audio you synthesized locally (deprecated) |
| GET | `/api/v1/oembed` | oEmbed for a watch URL |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bisque-cloud/openapi/_original/bisque-cloud-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-create-presentation-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-publish-narrated-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-ask-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-presentation-context-schema.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-create-presentation-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/bisque-cloud/json-schema/bisque-cloud-publish-narrated-result-schema.json

## Other Bisque APIs (1)

- [Bisque API](https://apis.io/apis/bisque-cloud/bisque-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bisque-cloud/bisque-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bisque-cloud/.