Koyeb

Koyeb sits between Fly.io and Render in the serverless cloud space — globally distributed edge deployment with auto-scaling and scale-to-zero. Differentiator: 60+ points of presence with automatic traffic routing to the nearest PoP, strong for globally distributed APIs. For agents managing deployment lifecycle: the REST API enables creating services, triggering deployments, inspecting deployment status, and managing environment variables. Free tier (2 nano services) is genuinely useful for small apps. Confidence is docs-derived.

REST API at app.koyeb.com/v1. Resources: apps, services, deployments, secrets, domains, instances. POST /v1/services creates a service (Docker image or GitHub repo, env vars, regions, scaling config). GET /v1/services/{id}/deployments lists deployments. POST /v1/services/{id}/deployments/latest/redeploy triggers redeployment. GET /v1/deployments/{id} retrieves deployment status (DEPLOYING, HEALTHY, UNHEALTHY). POST /v1/secrets creates a secret for environment variable injection. Service definition: ports, health check path, scaling (min/max instances, scale-to-zero), regions.

API token auth: Authorization: Bearer {api_token} header. Tokens from Koyeb Dashboard → Account Settings → API. Account-scoped tokens. HTTPS enforced. No OAuth2. Secrets management: sensitive env vars stored as Koyeb Secrets (encrypted at rest); referenced in service definition. No fine-grained token scoping beyond account level in standard tier.

Standard HTTP status codes with JSON error bodies. 401 for invalid token, 400 for malformed service definition, 409 for duplicate service name. Deployment transitions: DEPLOYING → HEALTHY or UNHEALTHY. Unhealthy deployments include logs in Koyeb Dashboard. Scale-to-zero: cold start latency on first request after idle (depends on image and runtime). Koyeb uptime at status.koyeb.com. Auto-scaling behavior documented; scaling events logged in deployment activity.

koyeb.com/docs covers service creation, deployment management, scaling, custom domains, secrets, and REST API reference. Getting started: create Koyeb account (free), deploy first service from Docker Hub via UI or CLI in under 5 minutes. Koyeb CLI (koyeb) wraps the REST API for command-line management. Framework guides for Next.js, FastAPI, Express, Django. Community via Koyeb Discord and GitHub.