Knowledge Graph

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

POST /v1/graph/cypher

Graph cypher

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

Request

Json — CypherRequest

struct CypherRequest {
    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::json!({"rows": rows})

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

POST /v1/graph/cypher-lite

Graph cypher lite

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

Request

Json — CypherLiteRequest

struct CypherLiteRequest {
    query: String,
    allow_updates: Option<bool>,
    enforce_transactions: Option<bool>,
    temporal: Option<TemporalClauseRequest>,
}

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!({"rows": rows})

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

POST /v1/graph/index/ensure/property

Graph index ensure property

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

Request

Json — EnsurePropertyIndexRequest

struct EnsurePropertyIndexRequest {
    property_name: 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:2369. Registration: akasha-daemon/src/main.rs:4428.

POST /v1/graph/index/ensure/composite

Graph index ensure composite

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

Request

Json — EnsureCompositeIndexRequest

struct EnsureCompositeIndexRequest {
    properties: Vec<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:2386. Registration: akasha-daemon/src/main.rs:4432.

GET /v1/graph/index/stats

Graph index stats

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.

stats

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

POST /v1/graph/fulltext/search

Graph fulltext search

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

Request

Json — GraphFulltextRequest

struct GraphFulltextRequest {
    query: 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::json!({"rows": rows})

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

POST /v1/graph/subdomain/query

Graph subdomain query

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

Request

Json — SubdomainQueryReq

struct SubdomainQueryReq {
    namespace: String,
    domain: String,
    subdomain: 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::json!({"rows": rows})

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

POST /v1/graph/alg/pagerank

Graph pagerank

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

Request

Json — PagerankRequest

struct PagerankRequest {
    damping: Option<f64>,
}

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.

r

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

POST /v1/graph/alg/shortest_path

Graph shortest path

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

Request

Json — ShortestPathRequest

struct ShortestPathRequest {
    source: String,
    target: 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.

r

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

POST /v1/graph/alg/components

Graph components

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

Request

Json — ComponentsRequest

struct ComponentsRequest {
    strong: Option<bool>,
}

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!({"communities": serde_json::to_value(&r).unwrap_or_default()}),

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

POST /v1/graph/microtheory/switch

Graph microtheory switch

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

Request

Json — MicrotheorySwitchRequest

struct MicrotheorySwitchRequest {
    name: 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, "keyspace": keyspace})

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

POST /v1/graph/microtheory/keyspace

Graph microtheory keyspace

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

Request

Json — MicrotheoryKeyspaceRequest

struct MicrotheoryKeyspaceRequest {
    name: 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, "keyspace": keyspace})

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

POST /v1/graph/tx/begin

Graph tx begin

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::json!({"tx_id": id.to_string()})

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

POST /v1/graph/tx/commit

Graph tx commit

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

Request

Json — GraphTxIdReq

struct GraphTxIdReq {
    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:9583. Registration: akasha-daemon/src/main.rs:4451.

POST /v1/graph/tx/rollback

Graph tx rollback

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

Request

Json — GraphTxIdReq

struct GraphTxIdReq {
    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:9602. Registration: akasha-daemon/src/main.rs:4452.

GET /v1/graph/schema

Graph schema metadata

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.

metadata

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

GET /v1/graph/health

Graph health

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>

Serialization is delegated or the handler returns a raw response. Consult the exact handler below; the OpenAPI response intentionally remains unconstrained.

Errors and validation

Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.

Source: akasha-daemon/src/main.rs:10285. Registration: akasha-daemon/src/main.rs:4454.