Aiadio API

Create Postgres in one request

After checkout, Aiadio gives you an API key. Send that key in the X-API-Key header when you create or inspect a database.

curl -X POST https://api.aiadio.com/v1/databases \
  -H "X-API-Key: dbn_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "agent-test",
    "expires_in": "1h",
    "allowed_cidr": "203.0.113.10/32"
  }'

API key header

Authenticated API requests use an individual Aiadio key. Keep your API key server-side. Do not expose it in frontend code or commit it to a public repository.

X-API-Key: dbn_live_your_key

Create a temporary database

Creates an isolated PostgreSQL database with the requested lifetime.

Example response

{
  "id": "db_8f4c2",
  "status": "ready",
  "postgres_url": "postgresql://...",
  "allowed_cidr": "203.0.113.10/32",
  "expires_at": "2026-09-07T15:00:00.000Z"
}

TTL and automatic cleanup

The supported TTL range is 1 hour to 30 days. Choose the shortest duration that fits the workload.

When the TTL expires, Aiadio removes the temporary database and role automatically.

Check database status

curl https://api.aiadio.com/v1/databases/db_8f4c2 \
  -H "X-API-Key: dbn_live_your_key"

You can also use the status checker on the homepage.

HTTP responses

Check the HTTP status code before reading a successful response. Error responses may include an error or message field with more detail.

{
  "error": "Description of the request problem"
}