v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Connectors

List connectors

Returns all connectors that belong to the authenticated user. Use this to discover connector_id values for filtering documents, for update/delete operations, or to trigger a syncronization job on demand. Connector configuration is included. Sensitive fields are never returned.

get/contents/v1/connectors

Response

List of connector objects in a results array. Each connector includes id, label, type, configuration and timestamps.

Example response

{
  "results": [
    {
      "connector_id": "019a9612-bfad-758c-884e-37dd8c6ad2cb",
      "user_id": "user_id_001",
      "org_id": "org_id_001",
      "share_with_org": true,
      "label": "Broker Research - Daily Reports",
      "description": "Collects daily reports from the broker's research team",
      "config": {
        "allowed_emails": [
          "user@example.com",
          "admin@example.com"
        ],
        "email_hash": "a1b2c3d4e5f6",
        "email": "connector@bigdata.com"
      },
      "files_count": 10,
      "last_sync_at": "2026-04-07T09:36:34.195040Z",
      "last_sync_status": "SUCCESS",
      "last_sync_count": 3200,
      "created_at": "2026-02-11T11:01:09.574095Z",
      "updated_at": "2026-02-11T11:01:09.574102Z"
    }
  ]
}