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)
Returns200
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)
Returns200
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)
Returns200
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)
Returns200
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)