minipostiz-devto-setup

name	minipostiz-devto-setup
description	Dev.to API setup for minipostiz-cli — generate API key, store credentials, posting format
type	setup

minipostiz-cli — Dev.to Setup

Dev.to has a simple REST API. One API key is all you need.

What you need

Credential	Flag
API Key	--apiKey
Tags (optional)	--tags (comma-separated, max 4)
Series (optional)	--series

---

Step 1 — Generate an API Key

1. Go to https://dev.to → sign in
2. Click your avatar → Settings
3. Extensions → DEV Community API Keys
4. Enter a description (e.g. minipostiz) → Generate API Key
5. Copy the key — it's shown once (but you can generate multiple)

---

Step 2 — Store in minipostiz-cli

minipostiz auth --platform devto --apiKey "YOUR_API_KEY"

# With optional defaults
minipostiz auth --platform devto \
  --apiKey "YOUR_API_KEY" \
  --tags "webdev,productivity,tools" \
  --series "My Series Name"

# Or via supercli
sc minipostiz auth set-devto --apiKey "YOUR_API_KEY"

---

Step 3 — Test

minipostiz auth verify --platform devto
minipostiz publish --platform devto --message "# My First Post

This is the body of the article published via minipostiz-cli."

---

Post format

Dev.to posts are articles. minipostiz-cli maps:

• First line of --message → article title (markdown heading stripped)
• Remaining lines → article body (markdown supported)

minipostiz publish --platform devto --message "# Article Title

## Introduction

Body content here. Supports **bold**, *italic*, \`code\`, etc."

---

Optional: tags and series

Tags and series can be set at auth time (applied to all posts) or overridden:

# Update auth to set default tags
minipostiz auth --platform devto --apiKey "KEY" --tags "javascript,node,cli"

---

Troubleshooting

Error	Cause	Fix
401 Unauthorized	Invalid API key	Regenerate key at dev.to → Settings → Extensions
422 Unprocessable	Article validation failed	Ensure title (first line) is non-empty
Post published but no tags	Tags not in auth	Add --tags to minipostiz auth --platform devto

Token lifetime

Dev.to API keys do not expire unless deleted from Settings → Extensions.