Documentation/Introduction

Feather API

The Feather API lets you manage your blogs and content programmatically. It's designed to work seamlessly with AI agents — every response includes a plain-English summary, affected resource IDs, and suggested next actions so agents can chain calls without extra logic.

Start the quickstart Browse the reference

Base URL

All endpoints are served from a single base URL. Include this prefix on every request unless otherwise noted.

https://api.feather.so

What you can do

The API currently supports:

Create a blog — provision a new Notion-backed blog under your account with a single call. Feather sets up the Content, Pages, Tags, and Authors databases in your Notion workspace automatically.
Discover actions — call GET /actions with your key to get a machine-readable list of every available endpoint, its parameters, and required scopes. Useful for agents building their own context.

Built for agents

Every response surfaces three agent-friendly fields alongside the data: a summary in plain English, the affected_resources that were created or changed, and a list of next_possible_actions the agent might consider. See Response shape for the full contract.

Where to next

Step 1

Authenticate

Generate a key and make your first authenticated request.

Step 2

Quickstart

Create a post, publish it, and read it back in under a minute.

Reference

Create a blog

Provision a Notion-backed blog with a single POST call.

Reference

Discovering actions

Hit /actions to introspect the full API surface from a key.