Lineage
Every registered lineage 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/lineage/graph | Lineage graph |
GET | /v1/lineage/nodes/:id | Lineage node get |
POST | /v1/lineage/impact | Lineage impact |
POST | /v1/lineage/verify | Lineage verify |
GET | /v1/lineage/stats | Lineage stats |
POST /v1/lineage/graph
Query the graph for a lineage subgraph starting from an optional root node. POST /v1/lineage/graph
| Availability | Source contract |
|---|---|
| Registration | config.enable_graph |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — LineageGraphReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
root_id | Option<String> | No; optional or defaulted | |
depth | Option<u32> | No; optional or defaulted |
struct LineageGraphReq {
root_id: Option<String>,
depth: Option<u32>,
}JSON field accesses in handler: id, label, lineage_type, relationship, source, target. Nested lookups are included; this list alone does not establish requiredness.
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!(resp)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/lineage.rs:100. Registration: akasha-daemon/src/lineage.rs:367.
GET /v1/lineage/nodes/:id
Get a single lineage node by its ID. GET /v1/lineage/nodes/:id
| Availability | Source contract |
|---|---|
| Registration | config.enable_graph |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| 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 field accesses in handler: id, label, lineage_type. Nested lookups are included; this list alone does not establish requiredness.
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!({"node": node})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/lineage.rs:172. Registration: akasha-daemon/src/lineage.rs:368.
POST /v1/lineage/impact
Count downstream nodes affected by a given lineage node via graph traversal. POST /v1/lineage/impact
| Availability | Source contract |
|---|---|
| Registration | config.enable_graph |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — LineageImpactReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
node_id | String | Yes |
struct LineageImpactReq {
node_id: String,
}JSON field accesses in handler: id. Nested lookups are included; this list alone does not establish requiredness.
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!(resp)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/lineage.rs:223. Registration: akasha-daemon/src/lineage.rs:369.
POST /v1/lineage/verify
Compute a SHA-256 hash of a lineage node's content for integrity verification. POST /v1/lineage/verify
| Availability | Source contract |
|---|---|
| Registration | config.enable_graph |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — LineageVerifyReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
node_id | String | Yes |
struct LineageVerifyReq {
node_id: String,
}JSON field accesses in handler: integrity_hash. Nested lookups are included; this list alone does not establish requiredness.
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!(resp)Errors and validation
Directly referenced error variants: Internal, InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/lineage.rs:264. Registration: akasha-daemon/src/lineage.rs:370.
GET /v1/lineage/stats
Aggregate counts of lineage nodes and edges from the graph. GET /v1/lineage/stats
| Availability | Source contract |
|---|---|
| Registration | config.enable_graph |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See 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.
JSON field accesses in handler: relationship, type. Nested lookups are included; this list alone does not establish requiredness.
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!(resp)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/lineage.rs:321. Registration: akasha-daemon/src/lineage.rs:371.