---
title: "List connectors"
method: GET
path: "/connectors"
tags: ["Manage Connectors"]
---

# List connectors

`GET /connectors`

Lists the connectors, which the current authenticated user has access to.

## Query parameters

- `id` string[]

## Response `200`

The list of connectors

- ConnectorConfig[]
  - `id` string — The unique identifier of the connector.
  - `active` boolean — Whether this connector is activated. If this flag is set to false, no connector client will be available for it. That means no requests can be performed to the connector.
  - `skipAutoDisable` boolean — Whether to skip the automatic disabling of this connector even when being not healthy.
  - `trusted` boolean — Whether the connector is a trusted connector. Trusted connectors will receive more information than normal connectors.
  - `params` object — Arbitrary parameters to be provided to the remote function with the event.
  - `capabilities` StorageCapabilities — Arbitrary parameters to be provided to the remote function with the event.
    - `preserializedResponseSupport` boolean — If the lambda supports pre-serialization.
    - `relocationSupport` boolean — If the lambda supports relocation events.
    - `maxUncompressedSize` integer — The maximum size of the payload, which the connector accepts as uncompressed data.
    - `maxPayloadSize` integer — The maximum size of the event, which this connector can directly receive.
    - `propertySearch` boolean — Whether searching by properties is supported. (Only applicable for storage connectors)
    - `searchablePropertiesConfiguration` boolean — Whether it's supported to configure the searchableProperties of spaces. (Only applicable for storage connectors)
    - `enableAutoCache` boolean — Whether automatic caching configuration for spaces is supported.
    - `clusteringTypes` string[] — A list of supported clustering types / algorithms. ("hexbin", "quad", "quadbin") (Only applicable for storage connectors)
  - `remoteFunctions` object — A map with Cluster-IDs as keys (cluster-id-1 & cluster-id-1) and a 'RemoteFunctionConfig' as value.
  - `remoteFunction` object — This property has been deprecated, please use remoteFunctions instead.
    - `type` 'Embedded' | 'AWSLambda' | 'Http', required — The remote function's type.
    - `id` string — The ID of this config.
    - `warmUp` integer — The number of containers to keep warmed up by sending health check requests in parallel to the remote function. This function can be disabled by setting warmUp to zero.
  - `connectionSettings` object — The connection and throttling settings.
    - `maxConnections` integer — The maximal amount of concurrent connector instances to use.
  - `defaultEventTypes` string[] — The default event types to register the connector for. Can be overridden in the space definition by the owner. The value of one individual array element is a composition of the event type and the phase, separated by a dot. For example \"ModifySpaceEvent\" as the event type plus "." plus "response" as phase.
  - `contactEmails` string[] — A list of email addresses of responsible owners for this connector. These email addresses will be used to send potential health warnings and other notifications.

## Other responses

- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.
- `404` — Not found.

---

[API](https://skmtc.net/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.net/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)