Skip to content
Embabel Worlds

Database engines this appliance carries a driver for, and their connection fields

GET
/api/v1/learn/databases/engines
curl --request GET \
  --url http://localhost:11044/api/v1/learn/databases/engines \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json

The databases this appliance can open, answered by GET /learn/databases/engines

object
engines
required

Every engine whose JDBC driver this image carries, each with the form that connects to it

Array<object>

One offerable database engine or API auth mode, and the form that connects with it. A client renders the form; it decides nothing

object
fields
required

The whole form, credentials included, in the order to show it

Array<object>

One field of a connection form

object
default
required

The value to pre-fill, which the server also uses when the field is sent blank; empty when there is none

string
label
required

The field’s label, to show

string
name
required

The key to send this field’s value under in the request’s fields map

string
placeholder
required

Hint text for an empty input; empty when there is none

string
required
required

True when the connection is refused 400 without a value, after default is applied

boolean
secret
required

True for a credential: mask it, and drop it once the call it was typed for has returned

boolean
id
required

The id to send back: ConnectDatabaseRequest.engine for a database, ConnectApiRequest.mode for an API

string
label
required

A name to show, e.g. PostgreSQL or Bearer token

string

Example generated

{
  "engines": [
    {
      "fields": [
        {
          "default": "example",
          "label": "example",
          "name": "example",
          "placeholder": "example",
          "required": true,
          "secret": true
        }
      ],
      "id": "example",
      "label": "example"
    }
  ]
}