ONDA API

ONDA API

Monitor and control the ONDA self-learning system for your projects.

Get ONDA Status

GET /v1/onda/status/:project_id

Returns the current self-learning status for a project.

Response:

{
  "project_id": "my-company",
  "enabled": true,
  "onda_level": 2,
  "current_b_score": 0.72,
  "last_iteration_at": "2025-03-20T04:00:00Z",
  "next_run_at": "2025-03-21T04:00:00Z",
  "consecutive_rejections": 0
}

Get Iteration History

GET /v1/onda/history/:project_id

Returns the history of self-learning iterations for a project.

Response:

{
  "iterations": [
    {
      "id": 42,
      "status": "completed",
      "target_component": "empathy",
      "lever_id": "persona",
      "b_before": 0.68,
      "b_after": 0.72,
      "delta_b": 0.04,
      "guardian_approved": true,
      "guardian_reason": "delta_V <= 0, all components above floor",
      "created_at": "2025-03-20T04:00:00Z"
    }
  ]
}

List Schedules

GET /v1/onda/schedules

Returns self-learning schedules for all projects.

Update Schedule

PATCH /v1/onda/schedules/:project_id

Update the self-learning schedule for a project.

Request body:

{
  "enabled": true,
  "cron_expression": "0 4 * * *"
}

Trigger Iteration

POST /v1/onda/iterate

Manually trigger a self-learning iteration for a project.

Request body:

{
  "project_id": "my-company"
}

Revert Iteration

POST /v1/onda/iterations/:iteration_id/revert

Revert a specific iteration, restoring the previous configuration.