Aionis API Reference

This section documents the public API surface for production integrations.

What you will learn

1. Which endpoint group to use for each integration task.
2. Which IDs to log for replay and incident analysis.
3. Where to find contract-level details for auth, errors, and operations.

How to use this section

1. Use the left sidebar to pick an endpoint group.
2. Use API Guide for auth, isolation, and integration guardrails.
3. Use Operations and Gates for release and incident workflows.

What this section gives you

1. Group-level intent for each API surface.
2. The identifiers you must keep if you want reliable replay and incident debugging.
3. Pointers to contract pages for request and response details.

Task to endpoint mapping

1. Persist new execution memory: use POST /v1/memory/write
2. Build prompt context from natural language: use POST /v1/memory/recall_text or POST /v1/memory/context/assemble
3. Enforce policy before action: use POST /v1/memory/rules/evaluate then POST /v1/memory/tools/select
4. Reconstruct and inspect a failed run: use POST /v1/memory/replay/runs/get and POST /v1/memory/resolve

Common integration fields

Always persist these fields in logs and telemetry:

1. request_id
2. tenant_id
3. scope
4. run_id
5. decision_id
6. commit_uri

Core request conventions

1. Send tenant_id and scope on every request unless your environment injects them by policy.
2. Use one auth mode consistently per environment.
3. Persist IDs from every response, not only from failures.
4. Treat request_id as mandatory operational metadata.

Quick endpoint map

Memory

POST /v1/memory/writePOST /v1/memory/recall_textPOST /v1/memory/context/assemble

Policy

POST /v1/memory/rules/evaluatePOST /v1/memory/tools/selectPOST /v1/memory/tools/feedback

Replay

POST /v1/memory/replay/runs/getPOST /v1/memory/replay/playbooks/run

Endpoint schema pages

1. Endpoint Schemas Index
2. POST /v1/memory/write
3. POST /v1/memory/recall_text
4. POST /v1/memory/context/assemble
5. POST /v1/memory/rules/evaluate
6. POST /v1/memory/tools/select
7. POST /v1/memory/resolve
8. POST /v1/memory/replay/runs/get

Suggested reading order

1. Authentication
2. Memory APIs
3. Policy APIs
4. Replay APIs
5. Error Model