---
title: "List the connectors used by the caller's toolboxes"
method: GET
path: "/toolbox/connector"
tags: ["Toolboxes"]
---

# List the connectors used by the caller's toolboxes

`GET /toolbox/connector`

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/toolbox/connector`
- Auth: HTTP bearer

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

- `limit` integer
- `cursor` string
- `q` string
- `type` 'stored' | 'automatic'

## Headers

- `X-Organization-Id` string

## Response `200`

OK

- object
  - `result` object[], required
    - `slug` string, required: Connector slug — the value to send as `GET /toolbox?connector_slug=`.
    - `name` string, required: Catalog label. Falls back to the slug when the connector no longer resolves, so an option always has something to draw.
    - `logo` string, nullable, required: 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.
    - `toolbox_count` integer, required: 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.
  - `next_cursor` string, nullable, required
  - `prev_cursor` string, nullable, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/elaichi/apis/elaichi-api.md) · [All operations](https://skmtc.dev/elaichi/apis/elaichi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elaichi/apis/elaichi-api/revisions/b22cfb7b6d15?raw)
