GeniffyDocs
Changelog Log In Get a key

People

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)

Returns 200

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)

Returns 201

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)

Returns 200

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)

Returns 200

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)

Returns 200

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)

Returns 200

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

Returns 200

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)

Returns 200

Field Type Description
merge_id integer required
undone boolean required
already boolean required It had been undone before
Last updated November 3, 2026