Databases
Managed database instances
Databases
List and inspect managed database instances (PostgreSQL, MySQL, Redis) provisioned via your project.
List Databases
GET /v1/databasesReturns databases for the current project.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
limit | integer | 20 | Items per page (max 100) |
sort | string | createdAt | Sort field (name, status, createdAt, engine) |
fields[databases] | string | — | Comma-separated sparse fieldset |
curl https://api.fugoku.com/v1/databases \
-H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"Response:
{
"data": [
{
"id": "db-abc123",
"type": "databases",
"attributes": {
"name": "prod-postgres",
"engine": "postgres",
"version": "16",
"status": "active",
"region": "lagos-1",
"size": "standard",
"storageGb": 100,
"vcpus": 4,
"ramMb": 8192,
"createdAt": "2026-08-01T00:00:00Z"
}
}
],
"meta": { "page": 1, "limit": 20, "total": 1, "totalPages": 1 }
}Get Database
GET /v1/databases/:idReturns details for a single database.
curl https://api.fugoku.com/v1/databases/db-abc123 \
-H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"Response:
{
"data": {
"id": "db-abc123",
"type": "databases",
"attributes": {
"name": "prod-postgres",
"engine": "postgres",
"version": "16",
"status": "active",
"region": "lagos-1",
"size": "standard",
"storageGb": 100,
"vcpus": 4,
"ramMb": 8192,
"connections": {},
"providerId": "prov-lat-1",
"externalId": "lat-db-987",
"errorMessage": null,
"createdAt": "2026-08-01T00:00:00Z",
"updatedAt": "2026-08-15T00:00:00Z"
}
}
}Database Attributes
| Attribute | Type | Description |
|---|---|---|
name | string | Database name |
engine | string | Database engine (postgres, mysql, redis) |
version | string | Engine version |
status | string | Database status (active, stopped, creating, error) |
region | string | Region identifier |
size | string | Instance size tier |
storageGb | integer | Storage in GB |
vcpus | integer | Number of vCPUs |
ramMb | integer | RAM in MB |
connections | object | Connection strings (host, port, etc.) |
providerId | string | Provider ID |
externalId | string | Provider-side database ID |
errorMessage | string|null | Error details if status is error |