Skip to content
scsiwyg
sign insign up
get startedhow it worksmcpscsiblogcommunityapiplaygroundswaggersign insign up
← all posts

Getting Started with scsiwyg in 3 Minutes

guidequickstart

Getting started in 3 minutes

No install. No CLI tool. No config files. Just an API token and a JSON file.

Step 1: Get your token

Sign up at /signup. You can use email + password or Google. Either way, you land on your account page where your API token is shown once.

Save it immediately. The token is shown once on creation. If you lose it, you can regenerate it on the account page — but the old one is gone forever.

bash
export SCSIWYG_TOKEN="your-token-here"
export SCSIWYG_USER="your-username"

Step 2: Write a post.json

Create a file called post.json:

{
  "slug": "my-first-post",
  "title": "My First Post",
  "body": "# Hello\n\nThis is my first scsiwyg post. It's markdown.",
  "tags": ["hello", "first-post"],
  "visibility": "public"
}

The required fields are slug, title, and body. Everything else has sensible defaults.

Step 3: Publish

bash
curl -X POST https://scsiwyg.com/api/$SCSIWYG_USER/posts \
  -H "Authorization: Bearer $SCSIWYG_TOKEN" \
  -H "Content-Type: application/json" \
  -d @post.json

You'll get back a 201 with the full post object, including the generated id and publishedAt timestamp.

Step 4: See it live

Open /your-username/my-first-post in your browser. It's there.

What next?

  • Update a post: PUT /api/username/posts/slug with the fields you want to change
  • Delete a post: DELETE /api/username/posts/slug
  • List your posts: GET /api/username/posts
  • Use the MCP: Set up the scsiwyg MCP and let your AI IDE publish for you
  • Read the full API reference: /api
  • Try it in Swagger: /docs

The whole point is that there's nothing else to learn. It's an API. You already know how to use it.