presentations

Create Public Program Presentation

Changed on Oct 18, 2026

Create a presentation from deck JSON, Markdown, a Markdown Doc, or just a title.

post/v2/public/ferry/programs/{program_id}/presentations

Request

Base URL
https://api.sanka.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/sankahq/apis/sanka-public-api/docs/v2/public/ferry/programs/:program_id/presentations/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

program_idstring required

Query parameters

workspace_idstring nullable

Headers

X-Workspace-Codestring

Request body

titlestring required

deckobject nullable

A sanka.deck/v1 deck. The presentations catalog (GET …/presentations/catalog) publishes its JSON Schema, limits and guidance. Give at most one of deck, markdown and sourceDocumentId; with none of them the presentation starts with one title slide.

markdownstring nullable

Markdown to lay out as slides: --- and the most frequent of the top two heading levels start slides; lists, tables, quotes, images and Mermaid fences become blocks.

sourceDocumentIdstring nullable

A Markdown Doc in the same Docs to convert; the Doc itself is unchanged.

pageSize'16:9' | 'a4-landscape' nullable

Slide size; overrides deck.page.size. Defaults to 16:9.

folderIdstring nullable

Docs folder to create the presentation in.

sourceRefstring nullable

Response

Successful Response

successtrue required

Changes

Oct 18, 202616f03a9e3ab9 Revision changes
- breaking
  added to the ////////// response property oneOf list for the response status
- info
  added sankaDiagram discriminator mapping keys to the ////////// response property for the response status
Oct 18, 2026cadc7ef65a04 Revision changes
- breaking
  added to the ///// response property oneOf list for the response status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added line sankaDiagram shape discriminator mapping keys to the ///// response property for the response status

Operation history (3 revisions)