List Connectors

Retrieve a list of available connectors.

GET /api/connectors

Authorization

• Analyst / Admin: Required. The connector catalog is internal data and is not anonymously enumerable. Unauthenticated requests receive 401; non-analysts receive 403.

Query Parameters

Parameter	Type	Required	Description
status	string	No	Filter by status: generating, testing, production, disabled
platform_name	string	No	Case-insensitive substring match on platform name
limit	number	No	Items per page (default: 20, max: 100)
offset	number	No	Items to skip (default: 0)

Response

{
  "connectors": [
    {
      "id": "conn_slack001",
      "platform_name": "Slack",
      "platform_url": "https://api.slack.com",
      "version": "1.2.0",
      "status": "production",
      "documentation_url": "https://api.slack.com/docs",
      "endpoints_count": 15,
      "auth_type": "oauth2",
      "created_at": "2024-01-01T00:00:00Z"
    },
    {
      "id": "conn_github001",
      "platform_name": "GitHub",
      "platform_url": "https://api.github.com",
      "version": "2.0.0",
      "status": "production",
      "documentation_url": "https://docs.github.com/en/rest",
      "endpoints_count": 22,
      "auth_type": "bearer",
      "created_at": "2024-01-10T00:00:00Z"
    }
  ],
  "total": 12,
  "limit": 20,
  "offset": 0,
  "has_more": false
}

note

The default (no-filter, first-page) request is cached; responses carry an X-Cache: HIT|MISS header.

Example Request

curl -X GET "https://api.traces.io/api/connectors?status=active" \
  -H "Authorization: Bearer <token>"

Example: Search by Platform

curl -X GET "https://api.traces.io/api/connectors?platform_name=slack" \
  -H "Authorization: Bearer <token>"