Getting Started/Discovering actions

Discovering actions

Not sure what the API can do? Hit /actions with your key to get a full list of available endpoints, their parameters, and required scopes — useful for agents building their own context.

GEThttps://api.feather.so/actions

This endpoint requires a valid Bearer token. Every registered action is returned regardless of whether your key has the scope to call it — use required_scope to filter what your key can actually perform.

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

Response

Actions are returned inside affected_resources.available_actions. Each entry describes one documented endpoint: its route string, description, required and optional parameters, and the scope needed to call it (null means any valid key may call it).

{
  "success": true,
  "action_performed": "list_actions",
  "summary": "Returned 2 documented API actions available on this service.",
  "affected_resources": {
    "available_actions": [
      {
        "route": "GET /actions",
        "description": "Lists every available API action with descriptions and parameter metadata for agent discovery.",
        "required_params": [],
        "optional_params": [],
        "required_scope": null
      },
      {
        "route": "POST /v1/blog/create",
        "description": "Creates a Notion database (blog) under the API key owner's default Notion parent page.",
        "required_params": [
          { "name": "blog_name", "type": "string", "description": "Human-readable title for the new blog." }
        ],
        "optional_params": [],
        "required_scope": "create:blog"
      }
    ]
  },
  "next_possible_actions": ["POST /v1/blog/create"]
}

OpenAPI schema

An OpenAPI 3.0.3 schema is also available at /openapi.json. No auth required — drop it into Postman, your codegen, or your agent's tool registry.

curl https://api.feather.so/openapi.json