API referenceInstance API
GUIDE & REFERENCE

Procedural Memory

Every registered procedural memory instance operation, with source-derived inputs, outputs, access policy, and errors.

This reference covers 6 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.

MethodPathOperation
POST/v1/memory/proceduresMemory procedure store
GET/v1/memory/procedures/listProcedure list
POST/v1/memory/procedures/getProcedure get
POST/v1/memory/procedures/deleteProcedure delete
POST/v1/memory/procedures/updateProcedure update
POST/v1/memory/procedures/searchProcedure search

POST /v1/memory/procedures

Memory procedure store

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

JsonProceduralStoreRequest

FieldRust typeRequired on inputNotes
procedureProcedureYes
struct ProceduralStoreRequest {
    procedure: Procedure,
}

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:7533. Registration: akasha-daemon/src/main.rs:4642.

GET /v1/memory/procedures/list

Procedure list

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

No typed JSON, query, or path extractor is declared in the handler signature. Headers or request objects may still be consumed; the signature below is authoritative.

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(list).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:9822. Registration: akasha-daemon/src/main.rs:4643.

POST /v1/memory/procedures/get

Procedure get

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

JsonProcedureIdReq

FieldRust typeRequired on inputNotes
idStringYes
struct ProcedureIdReq {
    id: 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!({"procedure": p.map(|v| format!("{v:?}"))}),

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:9836. Registration: akasha-daemon/src/main.rs:4644.

POST /v1/memory/procedures/delete

Procedure delete

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

JsonProcedureIdReq

FieldRust typeRequired on inputNotes
idStringYes
struct ProcedureIdReq {
    id: 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:9853. Registration: akasha-daemon/src/main.rs:4645.

POST /v1/memory/procedures/update

Procedure update

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

JsonProcedureUpdateReq

FieldRust typeRequired on inputNotes
idStringYes
procedureProcedureYes
struct ProcedureUpdateReq {
    id: String,
    procedure: Procedure,
}

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:9873. Registration: akasha-daemon/src/main.rs:4646.

POST /v1/memory/procedures/search

Procedure search

AvailabilitySource contract
Registrationconfig.enable_memory
Runtime servicememory
Handler dependenciesSee handler source and return expressions.

Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.

Request

JsonProcedureSearchReq

FieldRust typeRequired on inputNotes
queryStringYes
struct ProcedureSearchReq {
    query: 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::to_value(list).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:9887. Registration: akasha-daemon/src/main.rs:4647.

On this page