Skip to main content
PATCH
/
api
/
signals
/
types
Update Signal Types
curl --request PATCH \
  --url https://app.puffle.ai/api/signals/types \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>",
      "description": "<string>",
      "keywords": [
        "<string>"
      ],
      "prompt": "<string>",
      "enabled": true,
      "position": 4503599627370495,
      "allowedSources": [
        "<string>"
      ],
      "structuredConfig": {},
      "sourceOverrides": [
        {
          "sourceId": "<string>",
          "enabled": true,
          "extraKeywords": [
            "<string>"
          ]
        }
      ]
    }
  ]
}
'
{
  "updated": [
    "<string>"
  ],
  "errors": [
    {
      "id": "<string>",
      "error": "<string>"
    }
  ]
}
CLI: 
puffle signal type update --items <items>

​
Overview

Updates mutable fields on one or more signal types. Each item can change label, description, keywords, prompt, enabled, position, allowedSources, structuredConfig (structured types only), and sourceOverrides (per-source enable + extra keywords). Use this when a user tunes a type — editing keywords, reordering, or toggling individual datasources on or off.

​
AI agent notes

sourceOverrides is an atomic replace. Listing only the sources you want enabled cascades the unlisted ones off. Include every override you want to keep, even if its fields are unchanged.Built-ins ignore prompt. Built-in types have hardcoded prompts. Update keywords or structuredConfig to influence their behavior instead.Color is not updatable. Reordering a type does not reshuffle colors.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-item update outcomes.

​
updated
string[]
required
​
errors
object[]