API Introduction - selftune

Base URL

https://api.selftune.dev

All data endpoints require a Bearer token:

Authorization: Bearer st_live_...

API keys are created in the cloud dashboard or via the device code flow.

Endpoint Group	Limit
Push (`/api/v1/push`)	60 requests/hour
All other data endpoints	300 requests/hour

Rate limit headers are included in responses:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 295
X-RateLimit-Reset: 1705123456

All responses return JSON:

{
  "data": { ... },
  "error": null
}

Error responses:

{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Group	Endpoints
Push	Ingest telemetry from CLI
Skills	Query skill health and trends
Sources	Upload and manage cloud skill sources
Overview	Dashboard aggregate data
Proposals	Manage evolution proposals
Unmatched	View unmatched queries
Alerts	Configure alert rules
Signals	Contributor signal relay
Community Bundles	Shared community skill bundles
Jobs	Scheduled job state and run history
Badge	Embeddable health badges
GitHub	GitHub App integration and webhooks
Eval Seed	Generate synthetic eval cases from a snapshot
Eval Suites	Create and manage runnable eval suites
Improve Runs	Queue and inspect cloud improve runs
Improve Run Events	Stream live run events over SSE
Registry	Publish and query the skill registry