← Stackonopenapi.yaml ↓

OpenAPI 3.1 · stable

Stackon Public API

HTTP API for the Stackon agentic development environment.

Base URL
https://stackon.ai/api/v1
Auth
Bearer ht_… · scoped PAT
Rate limit
60 requests / min

Endpoints

13 operations

Traces

Spans, traces, and lifecycle. Lead-pillar surface — every agent run lands here.

  • POST/api/v1/runsRecord a one-shot run
  • GET/api/v1/tracesList recent traces
  • POST/api/v1/tracesStart a new trace
  • GET/api/v1/traces/{id}Get a trace with its spans
  • POST/api/v1/traces/{id}/spansAppend a span to a trace
  • POST/api/v1/traces/{id}/endMark a trace finished and roll up totals

Evals

Run evals against a trace and trigger eval-gate runs from CI.

  • POST/api/v1/traces/{id}/evals/runGrade a trace against all enabled evals
  • GET/api/v1/eval-gates/{slug}Get gate config + latest run
  • POST/api/v1/eval-gates/{slug}/runRun a gate synchronously (CI-friendly)

Bridge

BYO-compute daemon endpoints (separate `hbk_` token namespace).

  • POST/api/v1/bridge/pairDaemon claims a one-time pairing code
  • POST/api/v1/bridge/heartbeatDaemon ping (~30s)
  • GET/api/v1/bridge/jobs/nextPoll for next queued job
  • POST/api/v1/bridge/jobs/{id}/resultSubmit job result

Interactive explorer

Try every endpoint inline — auth headers, request bodies, live responses. Loads on demand to keep this page fast.