provider signals PATCH /api/projects/{project_id}/signals/scout/configs/{id}/
@utdk/posthog /api/projects/{project_id}/signals/scout/configs/{id}/
Update a scout config
Tune one scout: change its schedule (`run_interval_minutes`), `enabled`, or `emit` (dry-run) posture. `skill_name` is fixed. Enabling records `enabled_by` and is activity-logged since it drives spend.
id path required
A UUID string identifying this Signal scout config.
string
project_id path required
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
string

Try it

Authentication
Configure credentials for PostHog API
signalsScoutConfigUpdate
PATCH/api/projects/{project_id}/signals/scout/configs/{id}/
Tune one scout: change its schedule (`run_interval_minutes`), `enabled`, or `emit` (dry-run) posture. `skill_name` is fixed. Enabling records `enabled_by` and is activity-logged since it drives spend.

Parameters

required

A UUID string identifying this Signal scout config.

required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Input

The `signals-scout-*` skill this config controls. Set at creation, not editable.

Human-readable summary of what this scout investigates, sourced from the scout skill's `description` metadata. Use it for a quick steer on the scout's focus without loading the full skill body. Empty if the skill is not currently present on the team or carries no description.

Where this scout came from: `canonical` for a scout PostHog ships and maintains (seeded from `products/signals/skills/`), or `custom` for one a team hand-authored on this project. Use it to badge built-in vs custom scouts instead of a hardcoded name list. Defaults to `custom` if the skill is not currently present on the team.

Whether this scout runs on its schedule. Disabled scouts are skipped by the coordinator.

Whether the scout writes findings to the inbox. False = dry-run: it runs and logs but emits nothing.

Minutes between runs (30–43200). The scout runs once this interval has elapsed since its last run.

When the coordinator last dispatched this scout. Null if it has never run.

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import posthog from '@utdk/posthog';

await posthog.signalsScoutConfigUpdate()