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.comAuthentication
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
Memories
Add notes, pages, conversations and files; list, read, correct and forget.
Recall
context for your prompt, ask for an answer, search for ranked memories.
People
profile, brief and graph.
Sources
What was added, how learning went, and deleting a source.
Spaces
Which of your users have memory, and forgetting one.
Your key
Whose key this is, and which memory a call reaches.
The spec itself is at https://api.geniffy.com/v1/openapi.json, for generating a client of your own.