Semaphor
Discovery

List connections

Returns the connections available to your access token.

Start here when you need to discover which data sources your token can query. Each connection includes its type, SQL dialect, and capability flags that tell you how to navigate deeper (for example, whether the connection uses schemas).

If table-level security policies are assigned to the token, only connections that contain at least one allowed table are returned.

GET
/api/v1/connections

Authorization

BearerAuth
AuthorizationBearer <token>

A project-scoped access token. Generate one via the Token API.

In: header

Response Body

application/json

application/json

application/json

curl -X get "https://semaphor.cloud/api/v1/connections"
{
  "connections": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "dialect": "string",
      "capabilities": {
        "path": [
          "database"
        ],
        "labels": {
          "property1": "string",
          "property2": "string"
        },
        "prefixLevels": [
          "database"
        ],
        "dialect": "postgres"
      }
    }
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}