BUSINESS API

Turn Markdown into presentation-ready structure.

Send Markdown and receive structured slide JSON or a standalone HTML presentation. API keys are available on active Business plans.

Bearer API key authentication

60 requests per minute

100,000 characters per request

Authentication

Create a key in Settings, then send it in the Authorization header. The full key is shown once; SlidesMate stores only its SHA-256 hash.

Authorization: Bearer smk_your_key

Keep keys on your server. Do not embed them in browser JavaScript, public repositories, or shared documents.

Open API key settings

Create slides

POST /api/markdown

Separate slides with three hyphens. The default response is JSON containing the parsed title, theme, slide count, and slide objects.

curl https://slidesmate.com/api/markdown \
  -X POST \
  -H "Authorization: Bearer $SLIDEMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Board update\n\n---\n\n## Next steps\n\n- Ship the pilot",
    "format": "json"
  }'

{
  "success": true,
  "data": {
    "title": "Board update",
    "theme": "professional",
    "slideCount": 2,
    "slides": [
      { "title": "Board update", "content": "" },
      { "title": "Next steps", "content": "- Ship the pilot" }
    ]
  }
}

Response formats

JSON

Use format: "json" for structured data you can render or transform in your own workflow.

HTML

Use format: "html" to download a standalone Reveal.js presentation.

Errors and limits

400: Invalid JSON, empty Markdown, unsupported format, or request too large.
401: Missing, malformed, revoked, or unknown API key.
403: The key owner does not have an active Business plan.
429: More than 60 requests in the current one-minute window.
500: The conversion could not be completed. Retry with backoff.