API introduction

DBHost provides two APIs:

Control plane API (https://dbhost.app/api/v1/) — User-facing REST API authenticated with API keys. Use this from your applications, scripts, and CI/CD pipelines.
VPS agent API (https://agent.dbhost.app/) — Internal API for direct VPS operations. Authenticated with a shared secret. Used by the control plane; not intended for end users.

This reference documents the control plane API.

Base URL

https://dbhost.app/api/v1

All responses return JSON. Successful responses contain the resource directly. Errors use a standard envelope:

{
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database 'foo' does not exist",
    "details": []
  }
}

No rate limits are currently enforced. This may change as the platform scales.

⌘I