Developer preview: the SDK packages and api.geniffy.com go live at the developer launch.
GeniffyDocs
Log In Get a key

REST API

Every call is plain HTTPS with a bearer key, so any language that can make a web request can use Geniffy. The Python and TypeScript SDKs are thin layers over these calls.

Base address

https://api.geniffy.com

Authentication

Send your key in the Authorization header. Make keys under API keys in the Geniffy app; see Keys and spaces.

Authorization: Bearer gnf_live_...

Spaces

Name one of your users in the X-Geniffy-Space header, or as space in the body or the query string. What a request spells out beats the header. Leave both out for your own memory.

Responses

Responses are JSON. Every response carries an X-Request-ID header; see Request ids. An error carries a code you can branch on and a sentence written for a person; see Errors and limits.

Endpoints

The spec itself is at https://api.geniffy.com/v1/openapi.json, for generating a client of your own.

Last updated October 5, 2026