Eden REST API
Operational APIs
ProtocolREST / JSON
Base path
/api/v1AuthenticationBearer token
These APIs support production operation around notifications, trigger sources, backups, snapshots, pipelines, migration jobs, functions, and memory records.
Route Map
Notifications
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/notifications | List user notifications. |
| POST | /api/v1/notifications/read-all | Mark all user notifications read. |
| POST | /api/v1/notifications/{notification_id}/read | Mark one notification read. |
Trigger Sources
| Method | Route | Purpose |
|---|---|---|
| POST | /api/v1/triggers | Create a trigger source. |
| GET | /api/v1/triggers | List trigger sources. |
| POST | /api/v1/triggers/{source_id}/rules | Create a trigger rule. |
| GET | /api/v1/triggers/{source_id}/rules | List trigger rules. |
| DELETE | /api/v1/triggers/{source_id}/rules/{rule_id} | Delete a trigger rule. |
| POST | /api/v1/triggers/{source_id}/ingest | Ingest a trigger event. |
Backups
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/backups | List backups. |
| POST | /api/v1/backups | Create a backup. |
| GET | /api/v1/backups/{timestamp}/download | Download a backup. |
| DELETE | /api/v1/backups/{timestamp} | Delete a backup. |
Snapshots
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/snapshots | List snapshots. |
| POST | /api/v1/snapshots | Create a snapshot. |
| GET | /api/v1/snapshots/{snapshot} | Get a snapshot. |
| DELETE | /api/v1/snapshots/{snapshot} | Delete a snapshot. |
| GET | /api/v1/snapshots/{snapshot}/status | Get snapshot status. |
| POST | /api/v1/snapshots/{snapshot}/run | Run a snapshot. |
| POST | /api/v1/snapshots/{snapshot}/pause | Pause a snapshot. |
Pipelines
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/pipelines | List pipelines. |
| POST | /api/v1/pipelines | Create a pipeline. |
| GET | /api/v1/pipelines/{pipeline} | Get a pipeline. |
| DELETE | /api/v1/pipelines/{pipeline} | Delete a pipeline. |
| GET | /api/v1/pipelines/{pipeline}/status | Get pipeline status. |
| POST | /api/v1/pipelines/{pipeline}/run | Run a pipeline. |
| POST | /api/v1/pipelines/{pipeline}/pause | Pause a pipeline. |
Migration Jobs
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/migrations/jobs | List migration jobs in the current organization. |
| POST | /api/v1/migrations/jobs/verify | Verify durable tenant/job linkage for all jobs or an optional job_uuid; read-only. |
| GET | /api/v1/migrations/jobs/{job_uuid} | Get one migration job. |
Verification reports linkage blockers and recorded worker-error counts. It does not certify copied data or cutover correctness; use the migration's planning, execution, pause, resume, refresh, cancel, and cutover endpoints to handle the migration after reviewing the report.
Functions
| Method | Route | Purpose |
|---|---|---|
| POST | /api/v1/functions | Create a function endpoint. |
| POST | /api/v1/functions/{endpoint}/invoke | Invoke a function endpoint. |
Memories
Memory APIs are mounted when AI Orchestration runtime memory storage is configured.
| Method | Route | Purpose |
|---|---|---|
| GET | /api/v1/memories | List memory records. |
| GET | /api/v1/memories/export | Export memory records. |
| GET | /api/v1/memories/{id} | Get a memory record. |
| DELETE | /api/v1/memories/{id} | Delete a memory record. |