Skip to content

List the connectors used by the caller's toolboxes

GET /toolbox/connector

Lists the connectors that appear in the toolboxes `GET /toolbox` would return for this caller, and how many of those toolboxes hold each one. These are the options for `GET /toolbox?connector_slug=`, the same way `GET /connector/categories` is the options for `GET /connector?category=`. Build a connector filter on this rather than on `GET /connector`: the catalog offers connectors the caller has no toolbox for, and the empty list that follows selecting one reads as a bug. Filtering on any slug returned here yields exactly that row's `toolbox_count` toolboxes from `GET /toolbox` under the same `?type=`, so pass `?type=` here whenever you pass it there. `toolbox_count` counts distinct toolboxes over the caller's whole visible set, never over one page of it. Ordered most-used first, slug ascending as the tiebreak. Cursor-paginated. Visibility follows `GET /toolbox`: a connector reachable only through someone else's private toolbox is not listed.

Query Parameters

qstring

Prefix match on the connector slug (goo matches google-drive), not on the display name. LIKE wildcards are matched literally. Max 200 characters.

typestring

Mirrors GET /toolbox's ?type= and must be given the same value: stored counts only real, shareable toolboxes, automatic only the automatic global:…/connection:… rows, unset both. Any other value is a 400.

Possible values:
storedautomatic

Response Body

next_cursorstring,null
prev_cursorstring,null
resultobject[]
logostring,null

The connector's square icon when it has one, else its wordmark logo, else null — including when the catalog could not be reached, which costs an option its picture and never its place in the list. Render initials from name when it is null.

namestring

Catalog label. Falls back to the slug when the connector no longer resolves, so an option always has something to draw.

slugstring

Connector slug — the value to send as GET /toolbox?connector_slug=.

toolbox_countinteger

How many of the caller's visible toolboxes hold at least one tool from this connector, under the ?type= in force. Always at least 1 — this endpoint never offers an option that filters to nothing.

curl -X GET 'https://api.elaichi.ai/toolbox/connector' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.elaichi.ai/toolbox/connector', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import os
import requests

url = "https://api.elaichi.ai/toolbox/connector"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())