POST /publishMarketplaceListing

For most use cases, the slideless CLI is easier than calling this endpoint directly. The CLI command equivalent is slideless publish --kind <presentation|app|plan> --description "…", run from inside a linked deck folder.

When to use

Turn a presentation you own into a public marketplace listing. The listing is pinned to one immutable version of the deck — later pushes do not move it. To re-pin, call this endpoint again or use slideless listing update --republish-version. Publishing is free and instant — there is no review queue.

Endpoint

POST https://europe-west1-slideless-ai.cloudfunctions.net/publishMarketplaceListing

Auth

Header	Value
`Authorization`	`Bearer cko_…` — must belong to the presentation’s owner

The key must carry the marketplace:publish scope. See API keys.

Request body

{
  "presentationId": "0192f1c3-...",
  "kind": "presentation",
  "interactive": false,
  "description": "Investor-ready pitch skeleton — 8 slides, placeholder copy.",
  "slug": "q4-pitch-template",
  "title": "Q4 Pitch Template",
  "tags": ["pitch", "startup", "investor"],
  "techStack": ["html", "css"],
  "category": "business",
  "version": 3
}

Field	Type	Required	Description
`presentationId`	UUIDv7 string	yes	The deck to publish. Caller must be its owner.
`kind`	`"presentation"` \| `"app"` \| `"plan"`	yes	The listing’s purpose — message, machine, or blueprint. See The three kinds.
`interactive`	boolean	no	Whether the listing is interactive. The backend forces `true` for `app`; defaults to `false` for `presentation`.
`description`	string	yes	One- or two-line catalog summary.
`slug`	string	no	Permanent listing id. Lowercase, hyphenated, unique. Auto-derived from the title if omitted.
`title`	string	no	Listing title. Defaults to the presentation’s title.
`tags`	string[]	no	Search tags.
`techStack`	string[]	no	Technologies the listing is built with or built for, as free-form lowercase technology slugs (e.g. `["nextjs","firebase","n8n"]`). One canonical slug per technology; no display names or versions. Especially useful for `plan` listings. See Tech stack.
`category`	string	no	Category bucket.
`version`	number	no	Version to pin. Defaults to the deck’s current version.

The listing is created with status: "public". Use updateMarketplaceListing to switch it to unlisted.

Response (200)

{
  "success": true,
  "data": {
    "slug": "q4-pitch-template",
    "kind": "presentation",
    "interactive": false,
    "version": 3,
    "status": "public",
    "marketplaceUrl": "https://slideless.ai/marketplace/q4-pitch-template"
  }
}

Examples

curl

curl -sS -X POST \
  -H "Authorization: Bearer $SLIDELESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "presentationId": "0192f1c3-...",
    "kind": "presentation",
    "description": "Investor-ready pitch skeleton — 8 slides, placeholder copy.",
    "tags": ["pitch", "startup"]
  }' \
  https://europe-west1-slideless-ai.cloudfunctions.net/publishMarketplaceListing

Node.js

const res = await fetch(
  'https://europe-west1-slideless-ai.cloudfunctions.net/publishMarketplaceListing',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.SLIDELESS_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      presentationId: '0192f1c3-...',
      kind: 'presentation',
      description: 'Investor-ready pitch skeleton — 8 slides, placeholder copy.',
    }),
  }
);

const { data } = await res.json();
console.log(`Published: ${data.marketplaceUrl}`);

Errors

Status	Code	Cause	Fix
`400`	`invalid-argument`	Missing `kind`/`description`, or bad slug syntax	Supply both required fields; slugs are lowercase/hyphenated
`401`	`unauthenticated`	Missing or invalid API key	Set `Authorization`
`403`	`permission-denied`	Key lacks `marketplace:publish`, or caller is not the owner	Recreate the key with the scope; publish from the owner’s account
`404`	`not-found`	`presentationId` unknown	Verify the ID via `listMyPresentations`
`409`	`conflict`	Slug already taken, or the deck already has a listing	Pass a different `slug`, or use `updateMarketplaceListing`
`500`	`internal`	Backend error	Retry with backoff

GET /getMarketplaceListing — read back the listing you just published.
Publishing guide — the full end-to-end flow.

Getting Started

Why Slideless

Concepts

CLI

Guides

Plugin Skills

Claude Desktop (MCP)

Advanced: HTTP API

When to use

Endpoint

Auth

Request body

Response (200)

Examples

curl

Node.js

Errors

Next

​When to use

​Endpoint

​Auth

​Request body

​Response (200)

​Examples

​curl

​Node.js

​Errors

​Next

When to use

Endpoint

Auth

Request body

Response (200)

Examples

curl

Node.js

Errors

Next