API Reference

The Flaken Registry API is open and public at https://flaken-api.onrender.com. No authentication required.

List Flakes

GET /api/v1/flakes

Returns all available flakes. Supports optional query filters:

GET /api/v1/flakes?search=leveling
GET /api/v1/flakes?tag=xp
GET /api/v1/flakes?framework=discord.py

Get Flake Details

GET /api/v1/flakes/<name>

Returns the flake manifest (metadata, config options, exports, dependencies).

Download Flake

GET /api/v1/flakes/<name>/download

Returns the full flake manifest plus all source files. This is what the CLI uses when you run flaken add.

Publish Flake

POST /api/v1/flakes

Publish a new flake or update an existing one. Requires a JSON body with manifest and files fields.

Health Check

GET /health

Returns the server status and number of registered flakes.

Example

curl https://flaken-api.onrender.com/api/v1/flakes/leveling/download \
  | jq '.manifest.name, .manifest.description'