| 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
- Go to https://dev.to → sign in
- Click your avatar → Settings
- Extensions → DEV Community API Keys
- Enter a description (e.g.
minipostiz) → Generate API Key
- 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"
minipostiz auth --platform devto \
--apiKey "YOUR_API_KEY" \
--tags "webdev,productivity,tools" \
--series "My Series Name"
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:
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.
