API - workspace, reports and compliance
All paths are relative to https://api.wakora.io/v1/; see the overview
for tokens, scopes and errors.
Usage, team, keys, tokens
| Method | Endpoint | Scope | What it does |
|---|---|---|---|
| GET | /usage | read | The billing axes, live: hosts, sites, APM sites, devices, container groups, RUM views, log volume, flow volume, status pages. |
| GET | /status-pages | read | Your status pages with their public URLs. |
| GET | /team | admin | Members and their roles. |
| GET | /agent-keys | admin | Enrollment keys with per-key host counts and last use. |
| POST | /agent-keys | admin | Issue a key: label. The plaintext is in this one answer and never shown again. |
| DELETE | /agent-keys/{id} | admin | Revoke a key. Hosts already enrolled are not affected; only new registrations with that key stop. |
| GET | /tokens | admin | The workspace's API and MCP tokens. |
| DELETE | /tokens/{id} | admin | Revoke a token. |
SLA objectives and reports
| Method | Endpoint | Scope | What it does |
|---|---|---|---|
| GET | /slo | read | SLA objectives with their live 30-day error-budget state. |
| POST | /slo | admin | Save an objective: id (to edit an existing one), name, kind (host, service or site), ref (a host uuid, uuid/service, or a bare domain), target (90 to 99.999). |
| POST | /slo/{id}/delete | admin | Delete an objective. |
| GET | /reports/schedules | read | Scheduled report exports. |
| POST | /reports/schedules | admin | Add a schedule: report (digest, sla, capacity), cadence (weekly, monthly), onDay, hour (local to tz), tz (IANA name, default UTC), formats (pdf,csv), recipients. |
| POST | /reports/schedules/{id}/run | act | Send a schedule right now. |
| POST | /reports/schedules/{id}/delete | admin | Delete a schedule. |
| GET | /deliverability | read | E-mail deliverability per sender domain: SPF, DKIM, DMARC, blocklist status, score. |
| GET | /fleet/avg?days= | read | Per-host metric averages over N days, the data behind the capacity and idle-host views. |
Audit
| Method | Endpoint | Scope | What it does |
|---|---|---|---|
| GET | /audit?from=&to=&limit=&offset= | admin | The audit chain, newest first; limit caps at 500. Every row carries its hash and the previous row's hash. |
| GET | /audit/verify | admin | Walk the whole chain server-side and answer whether it is intact. |
Both are Business plan and above, like the Audit log tab. Exports you make through the
console carry the verification verdict in the file; through the API, call /audit/verify
and store the answer next to your export.
Definitions, marketplace, fleet rollout
| Method | Endpoint | Scope | What it does |
|---|---|---|---|
| GET | /defs | read | The signed definition catalog: versions, match summaries, per-probe previews down to the exact command or query, matched-host counts. |
| GET | /fleet/rollout | read | The rollout rings with members, versions and state, the latest release, and the workspace version pin. |
| GET | /market | read | The marketplace catalog with probe summaries and your install state. |
| GET | /market/mine | read | Your own templates, full definitions included. |
| GET | /market/{id} | read | One template with its full definition. |
| POST | /market | admin | Create a template: name, title, descr, def (the definition JSON). Authoring needs Pro and above; names are global and carry the community_ prefix. |
| POST | /market/{id} | admin | Update yours; the version bumps automatically. |
| POST | /market/{id}/publish | admin | Make a private template visible to the community. |
| POST | /market/{id}/submit | admin | Submit a published template for verified review. |
| POST | /market/{id}/install | admin | Install a community template for this workspace. Installing an unverified template through the API is as deliberate as clicking through the console warning. |
| POST | /market/{id}/uninstall | admin | Remove it again. |
| DELETE | /market/{id} | admin | Delete your template. |