Fiwano API Documentation

Authentication

All API requests require an API key in the X-API-Key header.

Create a key from the API Keys page in the portal. The full key is shown only once — save it securely. Lost keys cannot be recovered; revoke and create a new one.

curl https://fiwano.com/api/v1/channels \
  -H "X-API-Key: YOUR_API_KEY"

All keys start with mip_live_. Keys are hashed on our side.

Errors

Every error response has a detail field. Most domain errors use a human-readable string:

{ "detail": "Human-readable error description" }

Schema validation (422) uses a list of field errors. Some domain validation errors instead use a structured detail object (for example text_too_long when sending overlong text); the per-endpoint shapes are in the API Reference.

HTTP status codes