GeniffyDocs
Changelog Log In Get a key

Spaces

Which of your users have memory, where each of them is (their time zone), a copy of what is held for one, and forgetting one of them entirely. This page is generated from the API's own spec, so it says exactly what the API does.

Which of your users have memory

GET/v1/spaces
Parameter In Type Description
X-Geniffy-Space header string One of your own users, for every call this client makes. Leave it out for your own memory; a blank one is refused. (up to 128 characters)

Returns 200

Field Type Description
spaces array of SpaceRow required
total integer required

Set where a user is, so their dates read right

PUT/v1/timezone

What the person says is dated on their own clock: "tomorrow" said at 22:30 in Los Angeles is the next day there, whatever the day is in UTC, and 11/12 is read the way they write dates. Set it once for your own memory or for one of your users (the space). A save that says its own timezone, or whose times carry an offset, is read on that instead.

Parameter In Type Description
X-Geniffy-Space header string One of your own users, for every call this client makes. Leave it out for your own memory; a blank one is refused. (up to 128 characters)

Body (application/json)

Field Type Description
timezone string optional Where the person is: an IANA zone (Europe/Berlin) or an offset (+05:30). "" goes back to UTC (up to 64 characters)
date_order string optional How they write a numeric date: DMY (11/12 is 11 December) or MDY (12 November). "": their zone's way (up to 3 characters)
space string optional One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)

Returns 200

Field Type Description
space string optional The user it is for; null: your own memory
timezone string optional Where they are; null: UTC
date_order string optional DMY or MDY; null: their zone's way

Where a user is

GET/v1/timezone
Parameter In Type Description
space query string One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
X-Geniffy-Space header string One of your own users, for every call this client makes. Leave it out for your own memory; a blank one is refused. (up to 128 characters)

Returns 200

Field Type Description
space string optional The user it is for; null: your own memory
timezone string optional Where they are; null: UTC
date_order string optional DMY or MDY; null: their zone's way

Everything held for one of your users, as their copy

GET/v1/export

For a user who asks for a copy of what your app's memory holds about them: every memory, current or not (an older value, a clash, a guess), each with its status and the sentence it came from, every source that was added, every file kept, by path, and what the memory read from all of it: the stories of what happened, the rules and lessons, the promises and plans, and where things stand, each with its status. What was forgotten is gone, so it is not in it. Hand it to them as it is, with each file's text read by GET /v1/files?path=: one answer holding every text could be hundreds of megabytes.

Parameter In Type Description
space query string One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
X-Geniffy-Space header string One of your own users, for every call this client makes. Leave it out for your own memory; a blank one is refused. (up to 128 characters)

Returns 200

Field Type Description
exported_at string required
stored_in string required Where the memory is kept
memories array of ExportedMemory required Everything held, current or not, each with its status
sources array of Source required Everything that was added
files array of FileRow optional Every file kept, in path order: GET /v1/files?path= hands back each one's text, exactly as written
episodes array of ExportedEpisode optional Every story of what happened, oldest first, each with its status
lessons array of ExportedLesson optional Every rule, how-to and lesson, oldest first, in use or not
intentions array of ExportedIntention optional Every promise and plan, oldest first: open, done or dropped
now array of StateOut optional Where things stand, per project

Forget one of your users, entirely

DELETE/v1/spaces/{space}

Everything that user ever said, gone: the facts, the sources, all of it. This is the call to make when one of your own users asks to be forgotten, and it cannot be undone.

Parameter In Type Description
space path string
X-Geniffy-Space header string One of your own users, for every call this client makes. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
Last updated November 3, 2026