Episodic Memory
Every registered episodic memory instance operation, with source-derived inputs, outputs, access policy, and errors.
This reference covers 5 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.
| Method | Path | Operation |
|---|---|---|
POST | /v1/memory/episodic | Memory episodic insert |
GET | /v1/memory/episodic/:id | Memory episodic get |
PUT | /v1/memory/episodic/:id | Memory episodic update |
DELETE | /v1/memory/episodic/:id | Memory episodic delete |
POST | /v1/memory/episodic/search | Episodic search |
POST /v1/memory/episodic
Memory episodic insert
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — EpisodicInsertRequest
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
event | EpisodicEvent | Yes |
struct EpisodicInsertRequest {
event: EpisodicEvent,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"id": id})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:7465. Registration: akasha-daemon/src/main.rs:4635.
GET /v1/memory/episodic/:id
Memory episodic get
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Path — String
{
"type": "string"
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"item": item})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:7479. Registration: akasha-daemon/src/main.rs:4636.
PUT /v1/memory/episodic/:id
Memory episodic update
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Path — String
{
"type": "string"
}Json — EpisodicUpdateRequest
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
event | EpisodicEvent | Yes |
struct EpisodicUpdateRequest {
event: EpisodicEvent,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"ok": true})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:7499. Registration: akasha-daemon/src/main.rs:4636.
DELETE /v1/memory/episodic/:id
Memory episodic delete
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Path — String
{
"type": "string"
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"ok": true})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:7514. Registration: akasha-daemon/src/main.rs:4636.
POST /v1/memory/episodic/search
Episodic search
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — EpisodicSearchReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
text | Option<String> | No; optional or defaulted | |
query | Option<String> | No; optional or defaulted | |
limit | Option<usize> | No; optional or defaulted |
struct EpisodicSearchReq {
text: Option<String>,
query: Option<String>,
limit: Option<usize>,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::to_value(rows).unwrap_or(serde_json::json!([])),Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:8635. Registration: akasha-daemon/src/main.rs:4698.