Storage Volumes

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
`GET`	`/v1/storage/volumes`	Storage volume list
`POST`	`/v1/storage/volumes`	Storage volume create
`POST`	`/v1/storage/volumes/attach`	Storage volume attach
`POST`	`/v1/storage/volumes/detach`	Storage volume detach
`DELETE`	`/v1/storage/volumes/:id`	Storage volume delete

GET `/v1/storage/volumes`

Storage volume list

Availability	Source contract
Registration	`config.enable_kv`
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.

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.

records

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

POST `/v1/storage/volumes`

Storage volume create

Availability	Source contract
Registration	`config.enable_kv`
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 — VolumeCreateRequest

Field	Rust type	Required on input	Notes
`name`	`String`	Yes
`purpose`	`String`	Yes
`description`	`Option<String>`	No; optional or defaulted	Serde: `default`
`kms_key_version`	`Option<u64>`	No; optional or defaulted	Serde: `default`
`provider`	`VolumeProvider`	Yes

struct VolumeCreateRequest {
    name: String,
    purpose: String,
    #[serde(default)]
    description: Option<String>,
    #[serde(default)]
    kms_key_version: Option<u64>,
    provider: VolumeProvider,
}

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.

record

Errors and validation

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

Source: akasha-daemon/src/main.rs:3167. Registration: akasha-daemon/src/main.rs:4619.

POST `/v1/storage/volumes/attach`

Storage volume attach

Availability	Source contract
Registration	`config.enable_kv`
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 — VolumeAttachRequest

Field	Rust type	Required on input	Notes
`volume_id`	`String`	Yes
`namespace`	`String`	Yes
`purpose`	`Option<String>`	No; optional or defaulted	Serde: `default`

struct VolumeAttachRequest {
    volume_id: String,
    namespace: String,
    #[serde(default)]
    purpose: Option<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.

record

Errors and validation

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

Source: akasha-daemon/src/main.rs:3196. Registration: akasha-daemon/src/main.rs:4623.

POST `/v1/storage/volumes/detach`

Storage volume detach

Availability	Source contract
Registration	`config.enable_kv`
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 — VolumeDetachRequest

Field	Rust type	Required on input	Notes
`volume_id`	`String`	Yes

struct VolumeDetachRequest {
    volume_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.

record

Errors and validation

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

Source: akasha-daemon/src/main.rs:3237. Registration: akasha-daemon/src/main.rs:4624.

DELETE `/v1/storage/volumes/:id`

Storage volume delete

Availability	Source contract
Registration	`config.enable_kv`
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"
}

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.

record

Errors and validation

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

Source: akasha-daemon/src/main.rs:3264. Registration: akasha-daemon/src/main.rs:4625.

Storage Volumes

Inspect implementation

Inspect implementation

Inspect implementation

Inspect implementation

Inspect implementation

On this page