API reference

curl http://localhost:8080/health

"ok"

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "http://localhost:8080/api/workers/status?project_id=PROJECT_ID"

{
  "connected": 2,
  "workers": [
    {
      "worker_id": "available-1",
      "worker_name": "Available worker",
      "status": "idle"
    },
    {
      "worker_id": "worker-2",
      "worker_name": "Project worker",
      "status": "busy",
      "connected_at": "2026-04-04T09:45:00Z"
    }
  ]
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/workspaces

[
  {
    "workspace_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "role": "owner",
    "workspaces": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "plan": "free",
      "max_concurrent_executions": 10,
      "created_at": "2026-01-15T08:30:00Z"
    }
  }
]

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"New Workspace","max_concurrent_executions":5}' \
  http://localhost:8080/api/workspaces

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "name": "New Workspace",
  "slug": "new-workspace-1a2b3c4d",
  "plan": "free",
  "max_concurrent_executions": 5,
  "created_at": "2026-04-04T12:00:00Z"
}

curl -X PUT -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"max_concurrent_executions":5}' \
  http://localhost:8080/api/workspaces/b2c3d4e5-f6a7-8901-bcde-f12345678901

[
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "New Workspace",
    "max_concurrent_executions": 5
  }
]

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/workspaces/b2c3d4e5-f6a7-8901-bcde-f12345678901/stats

{
  "project_count": 3,
  "total_runs": 128,
  "passed": 118,
  "failed": 7,
  "errors": 3,
  "running": 1,
  "avg_duration_ms": 2410,
  "last_run_at": "2026-05-02T15:30:00Z",
  "pass_rate": 92.2,
  "job_count": 14
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/workspaces/b2c3d4e5-f6a7-8901-bcde-f12345678901/project-health

[
  {
    "project_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "recent_runs": [
      {
        "status": "failed",
        "created_at": "2026-08-19T10:00:00Z"
      },
      {
        "status": "passed",
        "created_at": "2026-08-19T11:00:00Z"
      }
    ],
    "recent_pass_rate": 50,
    "running": 0
  }
]

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/workspaces/a1b2c3d4-e5f6-7890-abcd-ef1234567890/projects

[
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Website QA",
    "created_at": "2026-02-01T09:00:00Z"
  }
]

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout Flow RPA","max_concurrent_executions":3}' \
  http://localhost:8080/api/workspaces/a1b2c3d4-e5f6-7890-abcd-ef1234567890/projects

[
  {
    "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "workspace_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Checkout Flow RPA",
    "max_concurrent_executions": 3,
    "created_at": "2026-04-04T12:30:00Z"
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/projects

[
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Website QA",
    "project_type": "qa",
    "workspace_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "created_at": "2026-02-01T09:00:00Z"
  }
]

curl -X PUT -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"max_concurrent_executions":null}' \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012

[
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Website QA",
    "max_concurrent_executions": null
  }
]

# Browser redirect endpoint. Start setup through:
curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN"   http://localhost:8080/api/projects/PROJECT_ID/github/install-url

HTTP/1.1 302 Found
Location: http://app.bernops-dev/projects/github?projectId=PROJECT_ID&github=installed

curl -X POST -H "X-GitHub-Event: installation" \
  -H "X-GitHub-Delivery: delivery-001" \
  -H "X-Hub-Signature-256: sha256=CALCULATED_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{"action":"created"}' \
  http://localhost:8080/api/github/webhooks

{
  "accepted": true,
  "delivery_id": "delivery-001",
  "status": "processed"
}

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github/install-url

{
  "url": "https://github.com/login/oauth/authorize?client_id=Iv1.example&redirect_uri=https%3A%2F%2Fapi.bernops.example%2Fapi%2Fgithub%2Fsetup&state=SIGNED_STATE",
  "expires_at": "2026-05-03T12:10:00Z"
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github/status

{
  "installed": true,
  "connected": true,
  "installations": [
    {
      "id": "installation-001",
      "account_login": "acme"
    }
  ],
  "repository": {
    "repo_full_name": "acme/web",
    "html_url": "https://github.com/acme/web",
    "default_branch": "main",
    "test_folder_path": "bernops/e2e"
  },
  "pull_requests": [],
  "can_manage": true,
  "can_install": true,
  "default_folder": "bernops/e2e"
}

curl -X DELETE -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github

{
  "installed": true,
  "connected": false,
  "repository": null,
  "pull_requests": []
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github/repos

{
  "installations": [
    {
      "installation": {
        "id": "installation-001",
        "account_login": "acme"
      },
      "repositories": [
        {
          "id": 123,
          "full_name": "acme/web",
          "default_branch": "main"
        }
      ]
    }
  ]
}

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"installation_id":"installation-001","github_repo_id":123,"test_folder_path":"bernops/e2e"}' \
  http://localhost:8080/api/projects/PROJECT_ID/github/repos/select

{
  "installed": true,
  "connected": true,
  "repository": {
    "repo_full_name": "acme/web",
    "html_url": "https://github.com/acme/web",
    "default_branch": "main",
    "test_folder_path": "bernops/e2e"
  }
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "http://localhost:8080/api/projects/PROJECT_ID/github/tree?recursive=true"

{
  "sha": "tree-sha",
  "entries": [
    {
      "path": "bernops/e2e/login.spec.ts",
      "type": "blob",
      "sha": "file-sha"
    }
  ],
  "truncated": false
}

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github/export-tests

{
  "pull_request": {
    "number": 42,
    "url": "https://github.com/acme/web/pull/42",
    "draft": true
  },
  "commit": {
    "branch_name": "bernops/update-tests-20260503121000-ab12cd34",
    "commit_sha": "commit-sha",
    "tree_sha": "tree-sha"
  },
  "exported": [
    {
      "job_id": "job-001",
      "path": "bernops/e2e/login.spec.ts"
    }
  ],
  "skipped": []
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/PROJECT_ID/github/pull-requests

{
  "pull_requests": [
    {
      "branch_name": "bernops/update-tests-20260503121000-ab12cd34",
      "status": "open",
      "draft": true,
      "pr_number": 42,
      "pr_url": "https://github.com/acme/web/pull/42"
    }
  ]
}

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/projects/project-001/variables

[
  {
    "id": "var-001",
    "name": "BASE_URL",
    "is_secret": false,
    "value": "https://app.example.com"
  },
  {
    "id": "var-002",
    "name": "API_TOKEN",
    "is_secret": true,
    "value": null
  }
]

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"API_TOKEN","description":"CI token","is_secret":true,"value":"secret-value"}' \
  http://localhost:8080/api/projects/project-001/variables

{
  "id": "var-002",
  "name": "API_TOKEN",
  "is_secret": true,
  "value": null,
  "secret_version": 1
}

curl -X PUT -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description":"Rotated token"}' \
  http://localhost:8080/api/project-variables/var-002

{
  "id": "var-002",
  "name": "API_TOKEN",
  "is_secret": true,
  "value": null,
  "secret_version": 2
}

curl -X DELETE -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:8080/api/project-variables/var-002

{
  "deleted": true
}

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value":"new-secret-value"}' \
  http://localhost:8080/api/project-variables/var-002/rotate

{
  "id": "var-002",
  "name": "API_TOKEN",
  "is_secret": true,
  "value": null,
  "secret_version": 3
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/jobs

[
  {
    "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "name": "Login Flow",
    "description": "Tests the sign-in flow end to end.",
    "file_name": "login.spec.ts",
    "created_at": "2026-03-10T14:00:00Z"
  }
]

curl -X POST -H "Authorization: Bearer bo_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Login Flow","code":"import { test } from ...","file_name":"login.spec.ts","max_concurrent_executions":1}' \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/jobs

{
  "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
  "name": "Login Flow",
  "code": "import { test } from '@playwright/test'; ...",
  "max_concurrent_executions": 1,
  "created_at": "2026-04-04T13:00:00Z"
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234

{
  "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "name": "Login Flow",
  "description": "Tests the sign-in flow end to end.",
  "code": "import { test } from '@playwright/test'; ...",
  "file_name": "login.spec.ts",
  "created_at": "2026-03-10T14:00:00Z"
}

curl -X PUT -H "Authorization: Bearer bo_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Login Flow v2","code":"import { test } from ...","max_concurrent_executions":1}' \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234

{
  "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "name": "Login Flow v2",
  "code": "import { test } from '@playwright/test'; ...",
  "max_concurrent_executions": 1,
  "updated_at": "2026-04-04T14:00:00Z"
}

curl -X DELETE -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234

{
  "message": "Job deleted successfully."
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234/runs

[
  {
    "id": "run-001",
    "status": "passed",
    "started_at": "2026-04-04T10:00:00Z",
    "completed_at": "2026-04-04T10:02:30Z"
  }
]

curl -X POST -H "Authorization: Bearer bo_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"base_url":"https://staging.example.com"}' \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234/execute

{
  "execution_id": "exec-a1b2c3d4",
  "status": "running",
  "worker_id": "worker-1"
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/jobs/e5f6a7b8-c9d0-1234-efab-345678901234/stats

{
  "total_runs": 42,
  "pass_rate": 95.2,
  "avg_duration_ms": 15200,
  "last_run_at": "2026-04-04T10:02:30Z"
}

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"test_files":[{"file_name":"checkout.spec.ts","code":"import { test } from "@playwright/test";"}],"base_url":"https://staging.example.com"}' \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/test-runs

{
  "execution_id": "exec-a1b2c3d4",
  "status": "running",
  "worker_id": "worker-1"
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/test-runs

[
  {
    "id": "exec-a1b2c3d4",
    "status": "passed",
    "job_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "started_at": "2026-04-04T13:00:00Z",
    "completed_at": "2026-04-04T13:02:15Z"
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/stats

{
  "total_runs": 156,
  "passed": 144,
  "failed": 7,
  "errors": 5,
  "running": 0,
  "avg_duration_ms": 2410,
  "last_run_at": "2026-08-19T12:00:00Z",
  "pass_rate": 92.3,
  "job_count": 12
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  "http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/run-activity?days=7&timezone=America%2FToronto"

[
  {
    "date": "2026-08-18",
    "passed": 18,
    "unsuccessful": 2,
    "active": 0
  },
  {
    "date": "2026-08-19",
    "passed": 11,
    "unsuccessful": 1,
    "active": 2
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/dashboard-runs

{
  "recent_runs": [
    {
      "id": "exec-a1b2c3d4",
      "job_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
      "status": "passed",
      "duration_ms": 2410,
      "created_at": "2026-08-19T12:00:00Z"
    }
  ],
  "latest_job_runs": [
    {
      "id": "exec-a1b2c3d4",
      "job_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
      "status": "passed",
      "duration_ms": 2410,
      "created_at": "2026-08-19T12:00:00Z"
    }
  ]
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/test-runs/exec-a1b2c3d4

[
  {
    "id": "exec-a1b2c3d4",
    "status": "passed",
    "project_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "worker_id": "worker-1",
    "started_at": "2026-04-04T13:00:00Z",
    "finished_at": "2026-04-04T13:02:15Z"
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/test-runs/exec-a1b2c3d4/logs

{
  "data": [
    {
      "timestamp": "2026-04-04T13:00:01Z",
      "level": "info",
      "message": "Running test: login.spec.ts"
    },
    {
      "timestamp": "2026-04-04T13:02:15Z",
      "level": "info",
      "message": "All tests passed."
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

curl -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/test-runs/exec-a1b2c3d4/steps

{
  "data": [
    {
      "event": "step:start",
      "title": "navigate to /login",
      "status": "running",
      "duration_ms": 320
    },
    {
      "event": "step:end",
      "title": "fill #email",
      "status": "passed",
      "duration_ms": 45
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key" \
  http://localhost:8080/api/test-runs/exec-a1b2c3d4/cancel

{
  "execution_id": "exec-a1b2c3d4",
  "status": "error",
  "message": "Run cancelled"
}

curl -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/external-jobs

[
  {
    "id": "job-001",
    "name": "Morning billing sync",
    "slug": "morning-billing-sync"
  }
]

curl -X POST -H "Authorization: Bearer YOUR_JWT_TOKEN"   -H "Content-Type: application/json"   -d '{"name":"Morning billing sync"}'   http://localhost:8080/api/projects/c3d4e5f6-a7b8-9012-cdef-123456789012/external-jobs

{
  "job": {
    "id": "job-001",
    "name": "Morning billing sync"
  },
  "api_key": {
    "key": "bo_live_abc123"
  }
}

curl -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/external-jobs/job-001

[
  {
    "id": "job-001",
    "project_id": "proj-001"
  }
]

curl -X PUT -H "Authorization: Bearer YOUR_JWT_TOKEN"   -H "Content-Type: application/json"   -d '{"retention_policy":{"events_days":7,"metrics_days":30,"attachments_days":7,"keep_run_summary_forever":true}}'   http://localhost:8080/api/external-jobs/job-001

[
  {
    "id": "job-001"
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/external-jobs/job-001/stats

{
  "total_runs": 12,
  "pass_rate": 91.7,
  "avg_duration_ms": 18420
}

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/external-jobs/job-001/metrics?name=invoices.processed"

[
  {
    "name": "invoices.processed",
    "value": 124
  }
]

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/external-jobs/job-001/runs?limit=5&offset=0"

{
  "data": [
    {
      "id": "run-001",
      "display_name": "Morning billing sync"
    }
  ],
  "total": 1,
  "limit": 5,
  "offset": 0
}

curl -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/external-jobs/job-001/cleanup-status

{
  "cleanup": {
    "status": "completed",
    "deleted_logs": 120
  }
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/external-jobs/job-001/cleanup

{
  "cleanup": {
    "status": "completed",
    "deleted_storage_objects": 1
  }
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"external_job_id":"job-001","external_run_id":"cron-2026-04-08T09:00:00Z","display_name":"Morning billing sync"}'   http://localhost:8080/api/ingest/runs

{
  "execution_id": "run-001",
  "status": "running",
  "duplicate": false,
  "progress_sequence": 0,
  "progress_revision": 0
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"event_id":"log-001","message":"Fetched 124 invoices"}'   http://localhost:8080/api/ingest/runs/run-001/logs

{
  "accepted": true,
  "duplicate": false
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"event":"step:start","title":"Fetch invoices"}'   http://localhost:8080/api/ingest/runs/run-001/steps

{
  "accepted": true,
  "duplicate": false
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"name":"invoices.processed","kind":"count","value":124}'   http://localhost:8080/api/ingest/runs/run-001/metrics

{
  "accepted": true,
  "duplicate": false
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"event_id":"progress-001","sequence":1,"current":62,"total":100,"stage":"processing"}'   http://localhost:8080/api/ingest/runs/run-001/progress

{
  "accepted": true,
  "duplicate": false,
  "progress": {
    "execution_id": "run-001",
    "event_id": "progress-001",
    "sequence": 1,
    "revision": 1,
    "mode": "count",
    "current": 62,
    "total": 100,
    "percent": 62,
    "stage": "processing",
    "message": "Processed 62 invoices",
    "reported_at": "2026-04-08T09:00:32Z",
    "updated_at": "2026-04-08T09:00:32.100Z"
  }
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -F "[email protected];type=application/json"   -F "event_id=att-001"   http://localhost:8080/api/ingest/runs/run-001/attachments

{
  "attachment_id": "att-001",
  "file_name": "report.json"
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"heartbeat_at":"2026-04-08T09:05:00Z"}'   http://localhost:8080/api/ingest/runs/run-001/heartbeat

{
  "execution_id": "run-001",
  "last_heartbeat_at": "2026-04-08T09:05:00Z"
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"finished_at":"2026-04-08T09:10:00Z","duration_ms":600000}'   http://localhost:8080/api/ingest/runs/run-001/complete

{
  "execution_id": "run-001",
  "status": "passed"
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -d '{"error":"Unable to process invoices"}'   http://localhost:8080/api/ingest/runs/run-001/fail

{
  "execution_id": "run-001",
  "status": "failed"
}

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/test-runs/run-001/metrics?limit=100&offset=0"

{
  "data": [
    {
      "name": "invoices.processed",
      "value": 124,
      "unit": "items"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0
}

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/test-runs/run-001/progress?limit=50&offset=0"

{
  "data": [
    {
      "execution_id": "run-001",
      "event_id": "progress-001",
      "sequence": 1,
      "revision": 1,
      "mode": "percent",
      "current": null,
      "total": null,
      "percent": 72.5,
      "stage": "uploading",
      "message": null,
      "reported_at": "2026-04-08T09:05:32Z",
      "updated_at": "2026-04-08T09:05:32.100Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/test-runs/run-001/attachments?limit=50&offset=0"

{
  "data": [
    {
      "file_name": "report.json",
      "content_type": "application/json",
      "size_bytes": 17
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

curl -H "Authorization: Bearer bo_live_your_api_key"   http://localhost:8080/api/test-runs/run-001/attachments/att-001/download

{
  "attachment_id": "att-001",
  "file_name": "report.json",
  "content_type": "application/json",
  "download_url": "http://127.0.0.1:54321/storage/v1/object/sign/execution-attachments/project/...",
  "expires_at": "2026-04-08T09:06:00Z",
  "expires_in_seconds": 300
}

curl -H "Authorization: Bearer bo_live_your_api_key"   "http://localhost:8080/api/projects/b0000000-0000-0000-0000-000000000001/wiki/pages?q=incident&archive=active&limit=50&offset=0"

{
  "pages": [
    {
      "id": "d2600000-0000-0000-0000-000000000201",
      "project_id": "b0000000-0000-0000-0000-000000000001",
      "title": "Incident response",
      "slug": "incident-response",
      "filename": "runbooks/incident-response.md",
      "revision": 3,
      "archived_at": null,
      "updated_at": "2026-08-16T10:30:00Z",
      "rank": 0.42
    }
  ],
  "q": "incident",
  "archive": "active",
  "limit": 50,
  "offset": 0,
  "capabilities": {
    "can_create": true,
    "can_export": true,
    "can_import": false
  }
}

curl -X POST -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -H "Idempotency-Key: create-incident-response-v1"   -d '{"title":"Incident response","slug":"incident-response","filename":"runbooks/incident-response.md","body_markdown":"# Incident response\n"}'   http://localhost:8080/api/projects/b0000000-0000-0000-0000-000000000001/wiki/pages

{
  "outcome": "applied",
  "code": "wiki_page_created",
  "page": {
    "id": "d2600000-0000-0000-0000-000000000201",
    "project_id": "b0000000-0000-0000-0000-000000000001",
    "title": "Incident response",
    "slug": "incident-response",
    "normalized_slug": "incident-response",
    "filename": "runbooks/incident-response.md",
    "normalized_filename": "runbooks/incident-response.md",
    "body_markdown": "# Incident response\n",
    "revision": 1,
    "archived_at": null,
    "created_actor_kind": "api_key",
    "created_actor_api_key_id": "d2600000-0000-0000-0000-000000000401",
    "created_actor_display": "d2600000-0000-0000-0000-000000000401",
    "updated_actor_kind": "api_key",
    "updated_actor_api_key_id": "d2600000-0000-0000-0000-000000000401",
    "updated_actor_display": "d2600000-0000-0000-0000-000000000401",
    "created_at": "2026-08-16T10:00:00Z",
    "updated_at": "2026-08-16T10:00:00Z"
  },
  "audit_event_id": "d2600000-0000-0000-0000-000000000501",
  "replayed": false
}

curl -i -H "Authorization: Bearer YOUR_JWT_TOKEN"   http://localhost:8080/api/projects/b0000000-0000-0000-0000-000000000001/wiki/pages/d2600000-0000-0000-0000-000000000201

{
  "page": {
    "id": "d2600000-0000-0000-0000-000000000201",
    "project_id": "b0000000-0000-0000-0000-000000000001",
    "title": "Incident response",
    "slug": "incident-response",
    "normalized_slug": "incident-response",
    "filename": "runbooks/incident-response.md",
    "normalized_filename": "runbooks/incident-response.md",
    "body_markdown": "# Incident response\n",
    "revision": 1,
    "archived_at": null,
    "created_actor_kind": "user",
    "created_actor_user_id": "d2600000-0000-0000-0000-000000000301",
    "created_actor_display": "d2600000-0000-0000-0000-000000000301",
    "updated_actor_kind": "user",
    "updated_actor_user_id": "d2600000-0000-0000-0000-000000000301",
    "updated_actor_display": "d2600000-0000-0000-0000-000000000301",
    "created_at": "2026-08-16T10:00:00Z",
    "updated_at": "2026-08-16T10:00:00Z"
  },
  "capabilities": {
    "can_read": true,
    "can_export": true,
    "can_update": true,
    "can_restore": true,
    "can_archive": true,
    "can_unarchive": false
  }
}

curl -X PUT -H "Authorization: Bearer bo_live_your_api_key"   -H "Content-Type: application/json"   -H 'If-Match: "wiki-page:d2600000-0000-0000-0000-000000000201:rev:1"'   -H "Idempotency-Key: update-incident-response-v2"   -d '{"title":"Incident response plan"}'   http://localhost:8080/api/projects/b0000000-0000-0000-0000-000000000001/wiki/pages/d2600000-0000-0000-0000-000000000201

{
  "outcome": "applied",
  "code": "wiki_page_updated",
  "page": {
    "id": "d2600000-0000-0000-0000-000000000201",
    "project_id": "b0000000-0000-0000-0000-000000000001",
    "revision": 2,
    "title": "Incident response plan"
  },
  "audit_event_id": "d2600000-0000-0000-0000-000000000502",
  "replayed": false
}