slidesfly

HTTP API

Build against the same publishing API used by the CLI and MCP

The OpenAPI YAML is the machine-readable source for request shapes, auth, response envelopes, error codes, and idempotent publish behavior.

Last tested: July 28, 2026Reference

Open the machine-readable contract

Use https://slidesfly.com/openapi.yaml as the canonical document. Pin or checksum the version your integration was tested against.

curl -fsSL https://slidesfly.com/openapi.yaml -o slidesfly-openapi.yaml

Authentication

Anonymous create routes do not require an account. Owned-deck routes use a Slidesfly API key or an authenticated browser session. Never place API keys or claim credentials in a query string.

Idempotent publishing

Publish create and update routes accept an optional Idempotency-Key. Use a new UUID for each intended publish operation and reuse it only when retrying that same operation.

Idempotency-Key: 8cbe2f31-0ad1-4f1b-a985-47d3c2869c29
Authorization: Bearer sk_...

Respect the dual-domain boundary

  • slidesfly.com hosts the app, docs, account surfaces, and write APIs.
  • slidesfly.xyz hosts reader pages and intentionally blocks account, billing, CLI, MCP, and deck-write APIs.
  • Do not send write operations to the content domain.