Skip to main content
Aktoh Cyber
Sign inStart free

API reference

Aktoh API reference

The endpoint shapes and requests below are illustrative specifications, not confirmation that a production API is available. Confirm access, supported operations, and limits with Aktoh before building an integration.

Authentication

Bearer tokens issued per workspace. Read tokens can dispatch and read runs; operator tokens are the only tokens that can approve a queued action. Tokens are scoped, rotatable, and never carry approval rights implicitly.

Metering

Every response includes X-Aktoh-Tokens-Used and X-Aktoh-Pool-Remaining. One credit is 1,000,000 tokens of agent work, drawn from your shared company or household pool.

Overage

Usage beyond the pool is billed at model cost plus your plan's published Aktoh rate per 1M tokens — $5.00 on Adventurer. See pricing for the current rates. The proposed response includes X-Aktoh-Overage-Rate.

Spend visibility

Usage reporting shows credit cost and remaining pool. Spend alerts do not cap usage; work beyond the included pool remains billable.

Rate limits

60 dispatches/minute and 600 reads/minute per workspace by default, raised on request. Limits are returned in X-RateLimit-Remaining and X-RateLimit-Reset; 429 responses include a Retry-After.

Idempotency

Send Idempotency-Key on any POST. Retries with the same key return the original result rather than dispatching the fleet twice.

Endpoints

The surface, in full.

MethodPathWhat it does
POST/v1/dispatchAsk the fleet a question. Returns a run id and streams specialist findings as server-sent events.
GET/v1/runs/{run_id}Full transcript: which specialists ran, what each found, the verdict, and any queued actions.
GET/v1/actions?status=queuedEvery action waiting on a human. Nothing here has executed.
POST/v1/actions/{id}/approveApprove a queued action. Requires an operator token and is written to the audit log.
POST/v1/actions/{id}/declineDecline with a reason. The fleet learns the boundary for next time.
GET/v1/nodesConnected nodes, coverage, and last check-in. Unlimited on every plan, including Adventurer.
GET/v1/usagePool balance, tokens consumed, overage to date, spend alerts, and usage projection.
GET/v1/auditAppend-only log of every agent decision and human approval, exportable as JSON or CSV.

Examples

Illustrative requests and responses

Dispatch the fleet

curl https://api.aktohcyber.com/v1/dispatch \
  -H "Authorization: Bearer $AKTOH_TOKEN" \
  -H "Idempotency-Key: 9f2c-run-001" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Did anyone in finance get phished this week?",
    "scope": ["identity", "email", "payments"],
    "approval_policy": "human_required"
  }'

Check pool, overage, and alerts

curl https://api.aktohcyber.com/v1/usage \
  -H "Authorization: Bearer $AKTOH_TOKEN"

{
  "period": "2026-08",
  "plan": "professional",
  "credits_included": 900,
  "credits_used": 742.3,
  "overage_credits": 0,
  "overage_rate_per_1m": 2.15,
  "alert_thresholds_pct": [50, 80, 100],
  "projected_total_usd": 2800
}

Approve a queued action

curl -X POST https://api.aktohcyber.com/v1/actions/act_71f3/approve \
  -H "Authorization: Bearer $AKTOH_OPERATOR_TOKEN" \
  -d '{ "note": "Confirmed with the CFO by phone." }'

These examples document the proposed API shape. Confirm production availability and access with Aktoh. Back to docs · See token rates by plan

Start free. Add credits only when the work justifies it.

Run the whole fleet across unlimited nodes at zero platform fee — you pay only for tokens. Move to a pooled plan when the usage justifies the lower rate.

Start free — $0 platform feeSee it work