Getting Started/Quickstart

Quickstart

Create your first Feather blog in under a minute. Run each step from your terminal as you go.

Get your API key

Go to Settings → API Keys in the Feather dashboard and create a key with the create:blog scope. Export it so the rest of these snippets pick it up automatically.

export FEATHER_API_KEY="fk_live_your_key_here"

Discover available actions

Call GET /actions to see everything the API can do. Agents can use this to build context before deciding what to call next.

curl https://api.feather.so/actions \
  -H "Authorization: Bearer $FEATHER_API_KEY"

Create a blog

Send a POST to /v1/blog/create with a name. Feather sets up four interconnected Notion databases — Content, Pages, Tags, and Authors — and returns the live URL.

curl https://api.feather.so/v1/blog/create \
  -X POST \
  -H "Authorization: Bearer $FEATHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "blog_name": "My Blog" }'

{
  "success": true,
  "action_performed": "create_blog",
  "summary": "Blog \"My Blog\" created.",
  "affected_resources": {
    "feather_blog_url": "https://abcdefgh.feather.blog",
    "blog_live_notice": "Give it about 2 minutes; the blog will be live on that URL."
  },
  "next_possible_actions": ["GET /actions"]
}

Keep going

Your blog is live. Next, read the Create a blog reference for all parameters, learn the standard response shape, or hit /actions to see what's available.