Skip to main content
PATCH
/
api
/
signals
/
sources
Update Sources
curl --request PATCH \
  --url https://app.puffle.ai/api/signals/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": "<string>",
      "enabled": true,
      "config": {}
    }
  ]
}
'
{
  "updated": [
    "<string>"
  ],
  "errors": [
    {
      "id": "<string>",
      "error": "<string>"
    }
  ]
}
CLI: 
puffle signal source update --items <items>

​
Overview

Batch upsert the caller’s per-source enable state and adapter config. Toggling enabled=false cascades to every signal type that uses that source until it is re-enabled. Use this when a user connects, disconnects, or reconfigures a datasource — for example, switching the LinkedIn Posts adapter to a different keyword list or pausing Reddit entirely.

​
AI agent notes

Cascade. Disabling a source disables it on every signal type. Re-enabling restores the prior state — the cascade is symmetric.Config shape. The config JSONB must match the adapter’s configSchema (see Get Sources). Adapters validate at scan time, so a bad config silently drops the next scan rather than failing the PATCH.Defaults. Creating a per-user row implicitly sets enabled: true.Batch shape. Returns updated (ids that succeeded) and errors (per-id failures).

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
items
object[]
required
Required array length: 1 - 50 elements

Response

Per-id update outcomes.

​
updated
string[]
required
​
errors
object[]