Rehydrate
POST /v1/rehydrate
Expand compact evidence pointers when an Agent or operator needs more detail.
Aionis keeps routine Agent context short. Rehydrate gives the host a path back to raw or fuller evidence only when needed.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
reason | string | Yes | Why the host needs to expand evidence. |
tenant_id | string | No | Tenant boundary. |
scope | string | No | Project or workspace boundary. |
memory_ids / node_ids | string[] | Conditional | IDs returned by guide context or Runtime records. |
client_ids | string[] | Conditional | Client-provided write IDs. |
anchor_id / anchor_uri | string | Conditional | Anchor reference to expand. |
mode | summary_only, partial, full, or differential | No | Expansion level. |
include_linked_decisions | boolean | No | Include linked guide and lifecycle decisions when available. |
At least one memory, node, client, or anchor reference should be supplied.
Example
curl -s http://127.0.0.1:3001/v1/rehydrate \
-H 'content-type: application/json' \
-d '{
"tenant_id": "default",
"scope": "checkout-migration",
"reason": "Need the raw verifier note before applying the patch.",
"memory_ids": ["mem_123"],
"mode": "partial",
"include_linked_decisions": true
}'SDK
const evidence = await aionis.rehydrate({
reason: "Need raw evidence before exact use.",
memory_ids: ["mem_123"],
mode: "partial",
include_linked_decisions: true,
});Response
Important fields:
| Field | Meaning |
|---|---|
contract_version | aionis_rehydrate_result_v1. |
operation | rehydrate. |
target | Target class, usually memory or payload. |
forget_effect | Lifecycle effect record for the rehydrate operation. |
result | Expanded evidence, linked decisions, and source metadata when available. |
Modes
| Mode | Use when |
|---|---|
summary_only | The Agent only needs a compact explanation. |
partial | The Agent needs the most relevant payload and linked decisions. |
full | The operator needs fuller raw evidence. |
differential | The host needs a comparison or delta. |