signals

Update the project's signals config

Partial update of the per-project singleton. Omitted fields keep their value.

post/api/projects/{project_id}/signals/config/

Request

Base URL: https://us.posthog.com
URL: https://us.posthog.com/api/projects/{project_id}/signals/config/
Auth: one of:
- HTTP bearer
- HTTP bearer

Path parameters

project_idstring required

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

Request body

idstring uuid required

autostart_enabledboolean nullable

Master switch for autonomous inbox PRs. Null (never set) leaves autostart on; set false to opt out, so actionable reports still generate and notify but the team never auto-starts an implementation task or opens a PR — reviewers open PRs manually.

default_autostart_priority'P0' | 'P1' | 'P2' | 'P3' | 'P4'

P0 - P0
P1 - P1
P2 - P2
P3 - P3
P4 - P4

default_slack_notification_channelstring nullable

Default Slack channel for this team's signal inbox notifications, in the same channel_id|#channel-name shape PostHog uses elsewhere (only the channel id is required). Null means no team-level default; per-user channels still apply.

autostart_base_branchesobject

Per-repository base branch overrides for auto-started inbox PRs, keyed by 'organization/repository'. The branch is what the auto-PR targets; omit a repo (or send {}) to keep targeting the repo default branch.

issue_tracking_integrationinteger nullable

Connected GitHub, GitLab, Linear, or Jira integration that self-driving opens a tracker issue in for each pull request it makes. Null turns tracker issues off, which is the default.

issue_tracking_configobject

Where in the tracker the issues land. Required keys depend on the integration kind: github -> {repository}; linear -> {team_id}; jira -> {project_key}; gitlab needs none, because its integration is already bound to one project. An optional 'label' is applied to created GitHub issues.

max_reports_per_dayinteger nullable

Daily cap on new reports surfacing to the inbox, counted per calendar day in the project's timezone. Once reached, signal ingestion, scout runs, and report research pause until local midnight. Null means unlimited.

default_open_pull_request_readyboolean

Whether self-driving pull requests open ready for review instead of draft, so the full CI matrix starts when the pull request is created. False by default. A reviewer's own github_open_pull_request_ready overrides this for reports that suggest them as reviewer.

github_issue_writeback_enabledboolean

Whether self-driving comments back on a GitHub issue that raised a report, linking to the report so everybody watching the issue knows it is being researched. The comment is public on the issue thread and carries a link only, never report content. False by default. Needs a GitHub integration that can reach the issue's repository.

pull_request_label_enabledboolean

Whether self-driving adds a label to every pull request it opens, so GitHub search, saved searches, and notification rules can separate them from other automation on the repository. False by default. Needs a GitHub integration that can reach the repository.

pull_request_labelstring nullable

The label name self-driving applies, at most 50 characters. Null or blank means 'self-driving'. The label is created in the repository when it does not exist yet. Only used while pull_request_label_enabled is true.

reports_generated_todayinteger required

How many reports first became visible in the inbox during the current project-timezone day. This is the count the daily report limit compares against.

daily_report_limit_reachedboolean required

Whether the team hit its daily report limit, pausing new report generation until local midnight. Always false when max_reports_per_day is null.

created_atstring date-time required

updated_atstring date-time required

Response