GeniffyDocs
Changelog Log In Get a key

Sources

What was added, how learning went, and deleting a source with what only it taught. This page is generated from the API's own spec, so it says exactly what the API does.

What was added, and how learning went

GET/v1/sources
Parameter In Type Description
limit query integer (at least 1; at most 200; default 100)
cursor query integer (at least 0; default 0)
space query string One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
external_id query string Only the source with this id of your own (up to 300 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
sources array of Source required
total integer required
next integer optional

Delete a source by your own id, or every source with some labels

DELETE/v1/sources

For a record your app deleted on its side: the source you added under its id, and every memory learned only from it. Or, with label instead, every source carrying those labels, such as everything from a data source your user disconnected: up to 100 a call, and more says to call again.

Parameter In Type Description
external_id query string The id you gave it when you added it (at least 1 character; up to 300 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
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, by your own id

Field Type Description
id string required Geniffy's id for the source
external_id string required Your own id for it
deleted boolean required

Returns 200, by labels

Field Type Description
sources_deleted integer required How many sources this call deleted, up to 100
more boolean required Other sources carry these labels: call again
labels object required The labels it kept to

One source, optionally waiting for it

GET/v1/sources/{source_id}
Parameter In Type Description
source_id path string
space query string One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
wait query number Hold the answer until it has finished learning, up to this many seconds (at most 50: it comes back still reading rather than cut off). Saves you a polling loop. (at least 0; at most 60; default 0)
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
source object required

Delete a source and what only it taught

DELETE/v1/sources/{source_id}
Parameter In Type Description
source_id path string
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)

What a source said, word for word

GET/v1/sources/{source_id}/text

A saved prompt, rule or document back word for word, not the facts learned from it: a note in its own paragraphs (spaces inside a line are tidied when it is saved), a conversation turn by turn with who said each, a file written to /v1/files exactly as written. Secrets are masked and a forgotten person is redacted, as in every other read. A long text comes in pages: read on from next until it is null.

Parameter In Type Description
source_id path string
space query string One of your own users. Leave it out for your own memory; a blank one is refused. (up to 128 characters)
offset query integer Where to start reading, in characters (at least 0; default 0)
limit query integer How many characters to return (at least 1; at most 100,000; default 20000)
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 string required
title string required
kind note, file, link required
chars integer required How long the whole text is, in characters
offset integer required Where this page starts
text string required This page of what the source said
next integer optional The offset to read on from; null at the end
Last updated November 3, 2026