What is lastingly true about someone, what to read first, and what connects to what. This page is generated from the API's own spec, so it says exactly what the API does.
What is lastingly true, and what is going on now
GET/v1/profile
Parameter
In
Type
Description
subject
query
string
One person in the memory; omit for its owner (up to 200 characters)
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
subject
string
optional
lasting
array of object
required
What stays true about them
current
array of object
required
What is going on just now
grouped
object
optional
memories
integer
required
Add a section to profiles
POST/v1/profile/sections
A section for every one of your users' profiles, or with a space named, for that user's only. A memory
goes in it when one of its keywords appears, or its topic is one of the section's. Sent again with the same
name, it is updated. Profiles regroup within a minute or so.
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
name
string
required
What the section is called, such as dietary or billing (at least 1 character; up to 60 characters)
description
string
optional
What belongs in it, for whoever reads the profile (up to 300 characters; default "")
keywords
array of string
optional
A memory goes in the section when one of these words is in it (up to 50 items)
topics
array of string
optional
Or when its topic is one of these (diet, employer, birthday...) (up to 50 items)
space
string
optional
One of your users, for a section only theirs. Left out, every user's (up to 128 characters)
Returns201
Field
Type
Description
id
integer
optional
Null for a built-in section
name
string
optional
description
string
optional
(default "")
keywords
array of string
optional
topics
array of string
optional
applies_to
string
required
every user, this user, or built in
The sections a profile is grouped into
GET/v1/profile/sections
The sections a user's profile is grouped into, your own first, then the built-in ones. With no user
named, the ones every user's profile has.
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
sections
array of SectionOut
required
Remove a section from profiles
DELETE/v1/profile/sections/{section_id}
Parameter
In
Type
Description
section_id
path
integer
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
id
integer
required
deleted
boolean
required
What to read before dealing with someone
GET/v1/brief
Parameter
In
Type
Description
subject
query
string
(up to 200 characters)
limit
query
integer
(at least 1; at most 200; default 60)
space
query
string
One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
label
query
array of string
A label to keep to, as name:value (label=channel:email). Repeat it for another name, which must match too, or for another value of the same name, which may match instead
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
subject
string
optional
summary
string
optional
memories
array of Memory
required
total
integer
required
Who and what the memory knows, and how they connect
GET/v1/graph
Each person, organization, project, product and place the memory knows, and a line wherever a memory states a
lasting relation between two of them (Arjun Rao works at Ringg), drawn only while that memory holds: when Arjun
moves to another company the line moves with him, and the old one is history. Every line has the memories that
put it there. Two records that may be one person are listed in possible_duplicates for you or your user to
answer; nothing is merged on a name alone.
Parameter
In
Type
Description
history
query
boolean
Also the lines that no longer hold, each with when it stopped (default false)
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
nodes
array of GraphNode
required
edges
array of GraphEdge
required
possible_duplicates
array of PossibleDuplicate
optional
Two nodes that may be one and the same, for a person to decide: they are never merged on a name alone
typing
boolean
optional
True while memories added before types were known are being typed; read again in a minute (default false)
Say whether two records are one and the same
POST/v1/graph/duplicates/{duplicate_id}
Yes merges the two, keeping the fuller name (Priya Nair, not Priya), with every memory and line of both; it
can be undone. No keeps them apart, and the pair is not suggested again.
Parameter
In
Type
Description
duplicate_id
path
integer
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)
Body (application/json)
Field
Type
Description
same
boolean
required
True: they are one and the same, so merge them. False: they are not; never ask again
Returns200
Field
Type
Description
id
integer
required
same
boolean
required
merge_id
integer
optional
The merge, to undo with POST /v1/graph/merges/{merge_id}/undo
Undo a merge
POST/v1/graph/merges/{merge_id}/undo
The two records apart again, each with its own memories and lines.
Parameter
In
Type
Description
merge_id
path
integer
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)