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