Skip to main content
GET
/
api
/
signals
/
settings
Get Settings
curl --request GET \
  --url https://app.puffle.ai/api/signals/settings \
  --header 'Authorization: Bearer <token>'
{
  "paused": false,
  "scanTimeUtc": "06:00"
}
CLI: 
puffle signal setting

​
Overview

Returns the caller’s signals pause flag and preferred daily scan time (HH:MM UTC on a 15-minute boundary). The scan time selects which 15-minute scheduler slot picks up the workspace each day. Use this when rendering the signals settings panel or before changing a setting via Update settings.

​
AI agent notes

UTC only. scanTimeUtc is always returned in UTC. Convert to the user’s local timezone before display.Future-proof shape. The response is an object ({ paused, scanTimeUtc }) so additional per-user signal preferences extend it cleanly.

Authorizations

​
Authorization
string
header
required

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

Response

Current signals settings.

​
paused
boolean
required

When true, the daily scan cron skips this user. Folded in from the dropped DAT-91 /signals/pause route.

​
scanTimeUtc
string
required

Daily scan time in UTC, 15-minute boundaries only. Display time-zone conversion is the FE's responsibility.

​
pipelineStatus
object
required

Current signal_pipeline_status row for the caller. null if no scan has ever run. Use this on the FE to switch the empty-feed copy between 'next scan in Xh' (idle) and 'scan running now' / 'first scan complete' states.