---
# @generated by sylphx-gen 0.1.0 from contracts@fb95f0c42a0ec5d8e3cb694c0054b529c0b24b184112c65ef60c9044b4ce61f9. Do not edit.
title: "Episodes"
description: "The `episodes` collection of Sylphx Knowledge: 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."
type: reference
product: knowledge
summary: "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…"
updated: 2026-09-28
order: 900
---

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`](/docs/api/episodes#get) | Gets an episode. |
| `GET` | [`list`](/docs/api/episodes#list) | Lists a space's episodes, newest first. The filter is limited to `kind` and `extraction`. |
| `POST` | [`create`](/docs/api/episodes#create) | Records an episode and returns at once (`remember`); extraction reads it afterwards. |
| `DELETE` | [`delete`](/docs/api/episodes#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](/docs/api/episodes/get)

## 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](/docs/api/episodes/list)

## 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](/docs/api/episodes/create)

## 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](/docs/api/episodes/delete)