devto

1# Dev.to
2 
3## Purpose
4Read and write the user's dev.to account: own profile, own articles (published, unpublished drafts, or all), public articles by any username, create articles (draft by default), update articles. Use when the user mentions dev.to, a blog post, or publishing an article.
5 
6## Tooling
7All commands go through `bin/devto.py`:
8 
9```bash
10bin/devto.py me                                                      # verify the API key
11bin/devto.py my-articles                                             # published articles
12bin/devto.py my-articles --state all                                 # published + drafts
13bin/devto.py articles-by-user --username ben                         # public reads, no key needed
14bin/devto.py article-create --title "My post" --body-markdown "..." --tags "ai,python"  # draft by default
15bin/devto.py article-create --title "My post" --body-file ./draft.md --tags "ai" --published  # confirm first: goes live
16bin/devto.py article-update --id 123456 --title "New title"          # confirm first
17```
18 
19## Auth
20- Provider id: `devto` (credential is collected as `custom.devto`)
21- Collection: API key via the secure credential flow (`credentials.request_api_access`); created at dev.to under Settings > Account. The key is sent as a plain `api-key: <key>` header, verbatim, never as Bearer.
22- Allowed hosts: `dev.to`
23- Status check: `bin/devto.py me` (must return `"ok": true`)
24 
25## Operating Rules
26…