コンテンツにスキップ

List database connections

GET
/api/admin/database-connections
Code sample: Shell / cURL
curl --request GET \
--url https://auth.example.com/api/admin/database-connections \
--header 'Authorization: Bearer <token>'

Lists setup-managed and admin-managed database connections with tenant assignment metadata. Platform authority is required.

Database connections visible to platform administrators.

Media type application/json
object
items
required
Array<object>
object
id
string
name
string
display_name
string
description
One of:
string
provider
string
Allowed values: d1 hyperdrive postgres mysql custom
config
object
key
additional properties
managed_by
string
read_only
boolean
has_credential
boolean
credential_key_version
One of:
integer
credential_updated_at
One of:
integer
credential_updated_by
One of:
string
status
string
Allowed values: active disabled
created_by
One of:
string
updated_by
One of:
string
created_at
integer
updated_at
integer
tenant_assignments
Array<object>
object
id
required
string
name
required
string
kind
required
string
Allowed values: tenant platform
key
additional properties
key
additional properties
total
required
integer
key
additional properties
Example
{
"items": [
{
"id": "dbc_123",
"name": "tenant-pii-postgres",
"display_name": "Tenant PII PostgreSQL",
"description": "External PostgreSQL database for tenant PII workloads.",
"provider": "postgres",
"config": {
"host": "db.example.com",
"port": 5432,
"database": "authrim_pii",
"ssl": {}
},
"managed_by": "admin",
"read_only": {
"not": {}
},
"has_credential": {},
"credential_key_version": 1,
"credential_updated_at": 1770000000000,
"credential_updated_by": "admin_123",
"status": "active",
"created_by": "admin_123",
"updated_by": "admin_123",
"created_at": 1770000000000,
"updated_at": 1770000000000,
"tenant_assignments": [
{
"id": "tenant_123",
"name": "Tenant",
"kind": "tenant"
}
]
}
],
"total": 1
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}