Episodes
An Episode is the source of everything in the graph: one write as it happened (a note, a message, a step result, a document chunk, an…
This method is not served on the public API.
api.sylphx.comdoes not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.
An Episode is the source of everything in the graph: one write as it happened (a note, a message, a step result, a document chunk, an imported row), with its provenance. Creating one is remember; extraction reads it afterwards and proposes entities and relations that cite it.
Service Sylphx Knowledge · Resource type knowledge.sylphx.com/Episode · Name pattern orgs/{org}/projects/{project}/envs/{env}/spaces/{space}/episodes/{episode} · Shape record
Not available yet. Sylphx Knowledge is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.
Fields
| Field | Type | What it is |
|---|---|---|
name | string | orgs/{org}/projects/{project}/envs/{env}/spaces/{space}/episodes/{episode}. |
uid | string | epi_<26 base32>; never reused. Output only. |
meta | ResourceMeta | Resource metadata. |
kind | EpisodeKind | What the episode is. Required. One of note, message, step_result, document_chunk, imported_row, structured. |
text | string | The text as written, at most 64 KiB. An episode has text, data, or both. |
data | struct | Structured content, for a caller that already knows the shape (an imported row, a form). |
occur_time | timestamp | When it happened in the world; default the time it was recorded. |
provenance | Provenance | Where it came from and who wrote it. |
entities | string[] | The entities the caller says the episode is about, as resource names; extraction adds the ones it finds. At most 50. |
extraction | Extraction | Where extraction stands. Output only. One of pending, done, failed, skipped. |
create_time | timestamp | When the episode was recorded. Output only. |
Methods
Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.
| Method | Call | What it does |
|---|---|---|
GET | get | Gets an episode. |
GET | list | Lists a space's episodes, newest first. The filter is limited to kind and extraction. |
POST | create | Records an episode and returns at once (remember); extraction reads it afterwards. |
DELETE | delete | Deletes an episode, the facts that cite only it, and its search and embedding entries; facts that also cite other episodes are re-scored. |
get
Gets an episode.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space/episodes/episode · scope knowledge:read · effect read · not available yet · Request, response and examples
list
Lists a space's episodes, newest first. The filter is limited to kind and extraction.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space/episodes · scope knowledge:read · effect read · not available yet · paginated · Request, response and examples
create
Records an episode and returns at once (remember); extraction reads it afterwards.
POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space/episodes · scope knowledge:write · effect write · not available yet · Request, response and examples
delete
Deletes an episode, the facts that cite only it, and its search and embedding entries; facts that also cite other episodes are re-scored.
DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space/episodes/episode · scope knowledge:write · effect destructive · not available yet · Request, response and examples