CloudInfraOS

API Overview

The CloudInfraOS REST API gives you programmatic access to projects, resources, costs, alerts, DNS, runbooks, and webhooks. Use it to automate your infrastructure workflows and integrate with your existing toolchain.

Base URL

https://app.stackpilot.dev/api

Authentication

Dashboard API requests authenticate with your session cookie (the same login as the app) — handlers verify it via getUser() on every mutating call. Scoped Bearer API keys are planned; see Authentication for the roadmap.

Rate Limits

The API enforces rate limits per user (or per IP on unauthenticated endpoints). On a rate-limited response (HTTP 429) the limits are returned in headers:

  • X-RateLimit-Limit — requests allowed per window
  • X-RateLimit-Remaining — requests remaining in current window
  • X-RateLimit-Reset — Unix timestamp when the window resets

API Endpoints

Projects

  • GET /api/projects — list all projects in your organization
  • POST /api/projects — create a new project
  • GET /api/projects/:id — get project details
  • PATCH /api/projects/:id — update a project
  • DELETE /api/projects/:id — delete a project

Resources

  • GET /api/resources — list synced resources across providers
  • GET /api/resources/:id — get resource details

Costs

  • GET /api/costs — list cost snapshots with optional date range
  • GET /api/costs/summary — aggregated cost summary by provider

Alerts

  • GET /api/alerts — list alerts and alert configurations
  • POST /api/alerts — create an alert rule
  • PATCH /api/alerts/:id — update an alert rule
  • DELETE /api/alerts/:id — delete an alert rule

See the detailed endpoint documentation: