Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.simplefunctions.dev/llms.txt

Use this file to discover all available pages before exploring further.

API keys

EndpointPurpose
GET /api/keysList your API keys (redacted)
POST /api/keysCreate new key
GET /api/keys/{id}Key metadata (no secret)
DELETE /api/keys/{id}Revoke
Keys take the form sf_live_<32-char-secret>. The secret is shown exactly once on creation.
curl -X POST -H "Authorization: Bearer $SF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"my-agent","scopes":["read","write"]}' \
  https://simplefunctions.dev/api/keys

CLI auth handshake

For browser-based login (the sf login flow):
EndpointPurpose
GET /api/auth/cliInitialize handshake (returns pollKey)
GET /api/auth/cli/poll?pollKey=...Poll until user completes browser login
POST /api/auth/cli/completeBrowser completion endpoint
The flow:
1

CLI initiates

GET /api/auth/cli returns a pollKey and a browser URL.
2

Open browser

CLI opens browser to URL.
3

User authorizes

Browser hits POST /api/auth/cli/complete after Supabase auth.
4

CLI polls

GET /api/auth/cli/poll?pollKey=... returns the issued API key once status: complete.

Signup

POST /api/signup
Public endpoint for new account creation. Returns Supabase session + initial API key.

See also

Authentication

Full auth model.

API keys

Key scopes and rotation policy.