Skip to main content
GET
/
api
/
signals
/
types
/
{id}
/
sources
List per-source settings for a signal type
curl --request GET \
  --url https://app.puffle.ai/api/signals/types/{id}/sources \
  --header 'Authorization: Bearer <token>'
{
  "sources": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "signal_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_id": "<string>",
      "enabled": true,
      "keywords_extra": [
        "<string>"
      ],
      "prompt_override": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

​
Overview

Returns the signal_type_sources rows for the signal type, ordered by source_id. Each row captures:
  • enabled — whether this source is queried for this type
  • keywords_extra — extra keywords appended to the signal-level keywords (case-insensitive dedup)
  • prompt_override — per-source prompt that takes priority over the signal-level scoring_prompt / search_prompt during classification
Rows are seeded on signal type creation (and again on migration when new adapters are added). This endpoint only reads existing rows — it never creates new ones. To mutate a row, call PUT /api/signals/types/{id}/sources/{sourceId}.

​
AI agent notes

This is the internal UI-facing endpoint. Third-party integrations should prefer the v1 public API under /api/v1/signals/types/{id}/sources.Empty array is legal. A signal type that predates the signal_type_sources table may have no rows yet — the pipeline treats this as “all sources enabled”. Calling updateSignalTypeSource on any sourceId will materialize the first row.Not the global source catalog. For the list of all registered adapters, use GET /api/signals/sources. For the user’s per-account enable toggle, use GET /api/signals/sources/config.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string<uuid>
required

Signal type UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Array of per-source override rows for this signal type. Empty if the type has no seeded rows yet.

​
sources
object[]
required