feat(seer): Add new bulk+single project Seer settings endpoints by srest2021 · Pull Request #114899 · getsentry/sentry

srest2021 · 2026-05-05T19:01:43Z

Fixes CW-1285

Depends on #115037

Adds endpoints for managing per-project Seer settings:

GET /api/0/projects/{org}/{project}/seer/settings/ — single-project settings read
PUT /api/0/projects/{org}/{project}/seer/settings/ — single-project settings update
GET /api/0/organizations/{org}/seer/projects/ — paginated list with search/sort/filter
PUT /api/0/organizations/{org}/seer/projects/ — bulk update across multiple projects

Both endpoints use the update_seer_project_settings helper from #115037 to translate high-level fields (agent, integrationId, stoppingPoint, scannerAutomation) into project options.

Supported filters (via `query` parameter)

Filter	Operators	Example
`id`	`=`, `!=`, `IN`, `NOT IN`	`id:1`, `id:[1,2,3]`
`name` (free text)	`=`, `!=`	`my-project`
`reposCount`	`=`, `!=`, `>`, `<`, `>=`, `<=`	`reposCount:>0`
`stoppingPoint`	`=`, `!=`, `IN`, `NOT IN`	`stoppingPoint:off`
`agent`	`=`, `!=`, `IN`, `NOT IN`	`agent:seer`, `!agent:cursor_background_agent`

Supported sort fields (via `sortBy` parameter)

name, -name, reposCount, -reposCount, agent, -agent, stoppingPoint, -stoppingPoint

Example: GET single project

GET /api/0/projects/sentry/test-seer-settings/seer/settings/

{
    "projectId": 2,
    "projectSlug": "test-seer-settings",
    "agent": "seer",
    "integrationId": null,
    "stoppingPoint": "code_changes",
    "scannerAutomation": true,
    "reposCount": 1
}

Example: PUT single project

PUT /api/0/projects/sentry/test-seer-settings/seer/settings/

{"stoppingPoint": "open_pr"}

{
    "projectId": 2,
    "projectSlug": "test-seer-settings",
    "agent": "seer",
    "integrationId": null,
    "stoppingPoint": "open_pr",
    "scannerAutomation": true,
    "reposCount": 1
}

Example: PUT bulk update

PUT /api/0/organizations/sentry/seer/projects/

{"query": "agent:cursor_background_agent reposCount>:0", "stoppingPoint": "open_pr"}

Returns 204 No Content.

linear-code · 2026-05-05T19:01:49Z

CW-1285 Create new project settings endpoint

github-actions · 2026-05-05T19:04:36Z

🚨 Warning: This pull request contains Frontend and Backend changes!

It's discouraged to make changes to Sentry's Frontend and Backend in a single pull request. The Frontend and Backend are not atomically deployed. If the changes are interdependent of each other, they must be separated into two pull requests and be made forward or backwards compatible, such that the Backend or Frontend can be safely deployed independently.

Have questions? Please ask in the #discuss-dev-infra channel.

github-actions · 2026-05-05T19:07:21Z

📊 Type Coverage Diff

✅ No new type safety issues introduced. Coverage: 93.45%

srest2021 · 2026-05-05T23:31:57Z

+def _annotate_queryset(queryset):
+    # ProjectOption.value is a LegacyTextJSONField — a text column storing JSON.
+    # Use LegacyTextJSONField as output_field. Coalesce fallback values must also
+    # be JSON-encoded to match what the DB stores.


This method is kind of ugly with the JSON stuff, but not sure how else to write this--we need the annotations for ordering (otherwise I would just filter in-memory using projectoptions get_option or get_value_bulk).

Basically the problem I ran into was that LegacyTextJSONField output has quotes, but setting a Coalesce default to Value(...) doesn't work for comparison because that wouldn't have quotes. So I am json.dumps'ing the hardcoded defaults.

srest2021 · 2026-05-06T21:37:25Z

@sentry review

srest2021 · 2026-05-06T23:30:58Z

@sentry review

srest2021 · 2026-05-07T17:35:46Z

@sentry review

…on_details

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit e7fc0b6. Configure here.}

cursor · 2026-05-07T21:56:51Z

+        data = serializer.validated_data
+        search_query = data.pop("query")
+
+        accessible_projects = self.get_projects(request, organization)


PUT handler misses projects visible in GET response

Medium Severity

The get handler calls self.get_projects(request, organization, include_all_accessible=True) but the put handler calls self.get_projects(request, organization) without include_all_accessible=True. This means the PUT handler operates on a narrower set of projects (only team-scoped) than the GET handler shows. A user could see a project in the paginated GET list, craft a bulk update targeting it, and the update would silently skip it because get_projects without include_all_accessible doesn't return it.

Additional Locations (1)

src/sentry/seer/endpoints/project_settings.py#L337-L338

^{Reviewed by Cursor Bugbot for commit e7fc0b6. Configure here.}

Relates to CW-1285 Tldr, add an unused helper and prep stuff for #114899. Adds `update_seer_project_settings`, a helper that translates high-level Seer settings (agent, stopping point, scanner automation) into the underlying project options. This centralizes the write logic so the upcoming bulk and single-project settings endpoints can share it instead of duplicating option-level writes. - **agent=seer**: clears required handoff options (point, target, integration_id) - **agent=cursor/claude**: sets handoff config, requires an integration ID - **stoppingPoint (non-off)**: sets tuning to MEDIUM and stores the stopping point value - **stoppingPoint=off**: sets tuning to OFF; leaves stopping point and auto_create_pr alone so that reenabling tuning restores the prior state - **stoppingPoint=open_pr**: sets auto_create_pr=True; any other stopping point clears it. Safe to set unconditionally since [auto_create_pr is only read when all other handoff options are non-null.](https://github.com/getsentry/sentry/blob/d254733b163432ca88ae796c05d415f97064cbbc/src/sentry/seer/autofix/utils.py#L622) - **stoppingPoint omitted**: tuning and auto_create_pr are left untouched - Options set to their registered default are deleted rather than stored

sentry · 2026-05-07T22:39:46Z

+                | Q(_handoff_target=Value(json.dumps(None), output_field=LegacyTextJSONField())),
+                then=Value(json.dumps(AutomationCodingAgent.SEER)),
+            ),
+            default="_handoff_target",


Bug: The Case expression for the agent annotation uses a literal string default="_handoff_target" instead of a column reference, which will cause filtering and sorting by agent to fail.
_{Severity: HIGH}

Suggested Fix

Wrap the default value in an F() expression to correctly reference the _handoff_target column value. Change default="_handoff_target" to default=F("_handoff_target") and import F from django.db.models.

Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not valid. Location: src/sentry/seer/endpoints/project_settings.py#L209 Potential issue: In `_annotate_queryset`, the `agent` annotation is defined using a Django `Case` expression. The `default` is set to the literal string `"_handoff_target"`. Because the `output_field` is `LegacyTextJSONField`, Django does not automatically convert this string to an `F()` expression. As a result, when a project has an external agent, the annotated `agent` field will contain the literal string `"_handoff_target"` instead of the actual value from the `_handoff_target` column. This breaks filtering and sorting by the `agent` field in the `OrganizationSeerProjectSettingsEndpoint` for both GET and PUT requests, as they will operate on the incorrect literal string.

Covered in test_get_sort_by_agent

Relates to CW-1285 Tldr, add an unused helper and prep stuff for #114899. Adds `update_seer_project_settings`, a helper that translates high-level Seer settings (agent, stopping point, scanner automation) into the underlying project options. This centralizes the write logic so the upcoming bulk and single-project settings endpoints can share it instead of duplicating option-level writes. - **agent=seer**: clears required handoff options (point, target, integration_id) - **agent=cursor/claude**: sets handoff config, requires an integration ID - **stoppingPoint (non-off)**: sets tuning to MEDIUM and stores the stopping point value - **stoppingPoint=off**: sets tuning to OFF; leaves stopping point and auto_create_pr alone so that reenabling tuning restores the prior state - **stoppingPoint=open_pr**: sets auto_create_pr=True; any other stopping point clears it. Safe to set unconditionally since [auto_create_pr is only read when all other handoff options are non-null.](https://github.com/getsentry/sentry/blob/d254733b163432ca88ae796c05d415f97064cbbc/src/sentry/seer/autofix/utils.py#L622) - **stoppingPoint omitted**: tuning and auto_create_pr are left untouched - Options set to their registered default are deleted rather than stored

JoshFerge · 2026-05-08T19:49:46Z

    "sentry:seer_automation_handoff_integration_id",
    "sentry:seer_automation_handoff_auto_create_pr",
    "sentry:autofix_automation_tuning",
+    "sentry:seer_scanner_automation",


this didn't exist before?

It's not part of the SeerProjectPreference model (I wrote this list so I could use it in the original SeerProjectRepository read/write helpers which use SeerProjectPreference), but since it's an autofix-specific setting I figured I'd add it to try and centralize all of our Seer settings into one place.

JoshFerge

there is a lot in this PR, and it looks good, but i'd like to take my time with reviewing it. is it possible to:

split the PR up into first an endpoint which contains the seer project endpont, and a second one for the bulk endpoint? that might make it easier to review

srest2021 · 2026-05-08T21:18:35Z

Splitting into #115230 and #115234

github-actions Bot added the Scope: Backend Automatically applied to PRs that change backend components label May 5, 2026

sentry-warden Bot reviewed May 5, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

Comment thread src/sentry/seer/endpoints/project_settings.py

github-actions Bot added the Scope: Frontend Automatically applied to PRs that change frontend components label May 5, 2026

vercel Bot deployed to Preview May 5, 2026 19:05 View deployment

github-advanced-security AI found potential problems May 5, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py Fixed

Comment thread src/sentry/seer/endpoints/project_settings.py Fixed

getsentry deleted a comment from github-actions Bot May 5, 2026

sentry-warden Bot reviewed May 5, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

srest2021 commented May 5, 2026

View reviewed changes

getsentry deleted a comment from github-actions Bot May 5, 2026

srest2021 commented May 5, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

sentry Bot reviewed May 6, 2026

View reviewed changes

Comment thread src/sentry/seer/autofix/utils.py Outdated

sentry Bot reviewed May 6, 2026

View reviewed changes

Comment thread src/sentry/seer/autofix/utils.py

add update_seer_project_settings helper, tests, and constants prep

878d082

srest2021 mentioned this pull request May 6, 2026

feat(autofix): Add high-level autofix settings update helper #115037

Merged

srest2021 changed the base branch from master to srest2021/CW-1285-utils-prep May 6, 2026 23:54

add bulk and single-project Seer settings endpoints

8829ef6

srest2021 force-pushed the srest2021/CW-1285 branch from f50de0a to 8829ef6 Compare May 7, 2026 00:03

🛠️ Sync API Urls to TypeScript

dbaab6f

vercel Bot deployed to Preview May 7, 2026 00:07 View deployment

srest2021 added 3 commits May 7, 2026 09:41

cleaning up

4e3acca

cleaning up

3499981

Merge branch 'srest2021/CW-1285-utils-prep' into srest2021/CW-1285

7aad2cb

use CODING_AGENT_ALIAS_TO_HANDOFF_TARGET from constants in organizati…

b30614a

…on_details

Merge branch 'srest2021/CW-1285-utils-prep' into srest2021/CW-1285

5b0413e

srest2021 marked this pull request as ready for review May 7, 2026 18:53

srest2021 requested review from a team as code owners May 7, 2026 18:53

srest2021 requested review from JoshFerge and ryan953 May 7, 2026 18:54

sentry Bot reviewed May 7, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

cursor Bot reviewed May 7, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

srest2021 added 4 commits May 7, 2026 13:56

sort by stopping point

28acf0f

use coding agent enum and remove dict

372f4a1

Merge branch 'srest2021/CW-1285-utils-prep' into srest2021/CW-1285

10e8c4d

remove alias conversion

696039d

cursor Bot reviewed May 7, 2026

View reviewed changes

Comment thread src/sentry/seer/endpoints/project_settings.py

srest2021 added 5 commits May 7, 2026 14:36

move to utils and use codingagentprovidertype

8e1043e

minimize diff

b22f7ed

minimize diff

e2aa4e4

Merge branch 'srest2021/CW-1285-utils-prep' into srest2021/CW-1285

b6291e5

update enum name and throw invalidsearchquery if op not supported

e7fc0b6

cursor Bot reviewed May 7, 2026

View reviewed changes

Base automatically changed from srest2021/CW-1285-utils-prep to master May 7, 2026 22:35

resolve merge conflicts

0572992

vercel Bot deployed to Preview May 7, 2026 22:38 View deployment

sentry Bot reviewed May 7, 2026

View reviewed changes

JoshFerge reviewed May 8, 2026

View reviewed changes

srest2021 closed this May 8, 2026

Uh oh!

Conversation

srest2021 commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Supported filters (via query parameter)

Supported sort fields (via sortBy parameter)

Example: GET single project

Example: PUT single project

Example: PUT bulk update

Uh oh!

linear-code Bot commented May 5, 2026

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

github-actions Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📊 Type Coverage Diff

Uh oh!

Uh oh!

Uh oh!

Uh oh!

srest2021 May 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

srest2021 commented May 6, 2026

Uh oh!

Uh oh!

srest2021 commented May 6, 2026

Uh oh!

Uh oh!

srest2021 commented May 7, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot May 7, 2026

Choose a reason for hiding this comment

PUT handler misses projects visible in GET response

Uh oh!

sentry Bot May 7, 2026

Choose a reason for hiding this comment

Uh oh!

srest2021 May 8, 2026

Choose a reason for hiding this comment

Uh oh!

JoshFerge May 8, 2026

Choose a reason for hiding this comment

Uh oh!

srest2021 May 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

JoshFerge left a comment

Choose a reason for hiding this comment

Uh oh!

srest2021 commented May 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

srest2021 commented May 5, 2026 •

edited

Loading

Supported filters (via `query` parameter)

Supported sort fields (via `sortBy` parameter)

github-actions Bot commented May 5, 2026 •

edited

Loading

srest2021 May 8, 2026 •

edited

Loading