REST API overview

DevFlow's REST API lives at https://api.devflow.io. It's the same surface our dashboard uses; nothing is private.

base URL and versioning

https://api.devflow.io/v1/...

The version is in the URL. We bump v1 → v2 only on breaking changes, with a minimum 12-month overlap. Field additions are not breaking. See /changelog for every release.

content type

JSON only. Request and response.

pagination

List endpoints are cursor-paginated:

curl -H "Authorization: Bearer $DEVFLOW_API_KEY"   "https://api.devflow.io/v1/monitors?limit=50"

Response:

{
  "data": [{ "id": "mon_01...", ... }],
  "next_cursor": "eyJpZCI6Im1vbl8wMS..."
}

Pass ?cursor=... on the next request. limit defaults to 50, max 200.

errors

{
  "error": {
    "code": "monitor_not_found",
    "message": "No monitor with id mon_01HK4MRWBC...",
    "request_id": "req_01HK..."
  }
}

The request_id is in every response and helps support find the request server-side. Always include it when emailing support@devflow.io.

rate limits

See rest-api-rate-limits for the per-tier quotas and the X-RateLimit-* headers we return.

auth

API keys / service accounts. See rest-api-authentication.

SDKs

• Node — see node-sdk.
• Terraform — see terraform-provider.
• Python and Go are community-maintained; links on /integrations.