Skip to main content
GET
/
api
/
signals
/
sources
List available signal sources
curl --request GET \
  --url https://app.puffle.ai/api/signals/sources \
  --header 'Authorization: Bearer <token>'
{
  "sources": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>",
      "icon": "<string>",
      "configSchema": {}
    }
  ]
}

​
Overview

Returns metadata for every registered datasource adapter — the source of truth for which source_id values are valid anywhere else in the signals API. Always includes all 11 adapters: linkedin_posts, reddit, news, linkedin_jobs, hiring_cafe, web_mentions, sec_filings, g2_capterra, bluesky, hacker_news, x_twitter. Each entry includes a human-readable label, optional description / icon, and an optional configSchema describing the shape of the per-user config JSONB that the adapter understands.

​
AI agent notes

This is the internal UI-facing endpoint. Third-party integrations should prefer the v1 public API under /api/v1/signals/sources.Static catalog. This list is baked into the registry — it doesn’t change per user. Cache it for a session.Pair with config endpoints. Use listSignalSourceConfigs to see which of these the caller has enabled, and updateSignalSourceConfig to toggle them on or off.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

All registered adapters. Always includes all 11 sources.

​
sources
object[]
required