Subnano Docs API Access Settings

Subnano Publishing API v1

The Publishing API lets you create drafts, upload images, and publish posts from scripts, automations, and agents.

Base URL:

https://subnano.me/api/v1

What v1 supports

  • Personal API key authentication
  • Draft lifecycle (create, list, get, update, delete)
  • Publish and unpublish transitions
  • Image uploads for content and OG images
  • Markdown content
  • Idempotent publish retries with Idempotency-Key

Quickstart

  1. Create an API key in Subnano settings (/settings/api-access).
  2. Store the key in a secure secret manager.
  3. Create a draft.
  4. Publish the draft.

Agent Skill File

Single-file skill for AI agents (no extra references required):

https://docs.subnano.me/skills/subnano-publishing-api/SKILL.md

Create draft:

curl -X POST "https://subnano.me/api/v1/posts" \
  -H "Authorization: Bearer $SUBNANO_PUBLISH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Agent draft",
    "description": "Draft created via API",
    "paidContentMarkdown": "# Hello from API\n\nDraft body.",
    "enablePaywall": true,
    "priceRaw": "100000000000000000000000000000",
    "primaryCategoryId": 4,
    "language": "en",
    "commentsEnabled": true
  }'

Publish draft:

curl -X POST "https://subnano.me/api/v1/posts/<postId>/publish" \
  -H "Authorization: Bearer $SUBNANO_PUBLISH_KEY" \
  -H "Idempotency-Key: 9d3de6d8-28be-493f-a790-0938f63c50e1"

Next pages