feat(preprod): Add public install-details endpoint and shared utilities by trevor-e · Pull Request #109583 · getsentry/sentry

trevor-e · 2026-02-27T18:03:33Z

Summary

Split from #109377. Adds the install-details public endpoint and the shared utilities that the /latest endpoint also depends on.

Install Info — GET /api/0/organizations/{org}/preprodartifacts/{artifact_id}/install-details/
Returns distribution and installation details for a specific artifact: installability state, download URL, download count, release notes, install groups, and iOS-specific code signing info (signature validity, profile name, codesigning type). Always returns 200 with the install state rather than 404 when not installable.
Extracts a shared ArtifactInstallInfo dataclass in build_distribution_utils.py so the new public install info endpoint and the existing experimental ProjectPreprodInstallDetailsEndpoint share install-state computation logic without duplicating it.
Adds platform property to PreprodArtifact model and consolidates platform mapping.

Testing locally:

➜  sentry git:(telkins/public-bd-apis-install-details) curl -s -H "Authorization: Bearer $SENTRY_LOCAL_TOKEN" 'http://dev.getsentry.net:8000/api/0/organizations/sentry/preprodartifacts/7/install-details/' | python -m json.tool
{
    "buildId": "7",
    "appInfo": {
        "appId": "com.example.iosapp",
        "name": "Iosapp",
        "version": "3.0.0",
        "buildNumber": 200,
        "artifactType": "XCARCHIVE",
        "dateAdded": "2026-02-25T22:42:11.075010+00:00",
        "dateBuilt": null
    },
    "platform": "APPLE",
    "isInstallable": true,
    "installUrl": "http://dev.getsentry.net:8000/api/0/projects/sentry/internal/files/installablepreprodartifact/a_rRKc7yv8gsRW6K/?response_format=plist",
    "downloadCount": 8,
    "releaseNotes": "New login flow with biometric support",
    "installGroups": null,
    "isCodeSignatureValid": true,
    "profileName": "iOS Distribution Profile",
    "codesigningType": "app-store"
}

- Add organization-scoped public install-details endpoint - Add platform property to PreprodArtifact model - Add ArtifactInstallInfo and get_artifact_install_info utility - Refactor existing install-details endpoint to use shared utility - Refactor size_analysis tasks to use model platform property - Add install info response models and OpenAPI examples

github-actions · 2026-02-27T18:03:49Z

🚨 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.

src/sentry/preprod/models.py

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.}

src/sentry/preprod/api/endpoints/project_preprod_artifact_install_details.py

Compare against Platform.APPLE and Platform.ANDROID enum members instead of raw string literals for consistency and type safety. Co-Authored-By: Claude <noreply@anthropic.com>

Uppercase the platform enum value in public endpoint responses for consistency with other enum fields like artifactType. Internal endpoints are unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

Consolidate public build distribution response models into a single file, consistent with how size_analysis.py is organized.

noahsmartin · 2026-02-27T21:21:15Z

src/sentry/preprod/api/endpoints/project_preprod_artifact_install_details.py

+            "install_groups": info.install_groups,
        }

-        # Only include iOS-specific fields for iOS apps


Why remove this comment?

No strong reason, I removed some other comments earlier in the file and this one also seemed like an obvious comment based on the if head_artifact.artifact_type == PreprodArtifact.ArtifactType.XCARCHIVE: code.

…ept-encoding * origin/master: (63 commits) fix(api): Add missing cursor query parameter to paginated endpoint OpenAPI schemas (#109642) docs(sentry-apps): Add sentryAppId to sentry-app-installations API schema (#109628) feat(occurrences on eap): Implement double reads from EAP in organization events trace API endpoint (#109391) feat(occurrences on eap): Implement double reads from EAP for reprocessing2 flow (#109345) feat(ci): report backend test fails (#109543) feat(seer): Add signed viewer context header to Seer API requests (#109626) devenv: cleanup devenv-managed uv (#109617) feat(seer): Iterate on the instructions at the top of seer settings pages (#109586) ref(seer): Add typed wrappers for remaining Seer API callsites (#109607) feat(preprod): Make snapshots endpoint org scoped (#109575) chore: capture exception (#109620) fix(formatting): run ruff format (#109618) feat(preprod): Create admin gated recompare snapshots endpoint (#109546) feat(cells): expand locality/cell distinction (#109538) feat(cells): add db migration for synapse (#109615) feat(preprod): Add public install-details endpoint and shared utilities (#109583) fix(tests): Fix flaky test_cross_trace_query_with_spans_and_logs (#109572) fix(grouping): Resolve mypy possibly-undefined errors in grouphash caching (#109602) fix(dashboards): Default axisRange to auto for existing widgets in builder (#109598) fix(billing): Fix category display names in pending changes (#109612) ...

trevor-e requested review from a team as code owners February 27, 2026 18:03

github-actions bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Feb 27, 2026

trevor-e mentioned this pull request Feb 27, 2026

feat(preprod): Add public build-distribution/latest endpoint #109584

Open

3 tasks

github-actions bot added the Scope: Backend Automatically applied to PRs that change backend components label Feb 27, 2026

vercel bot deployed to Preview February 27, 2026 18:05 View deployment

sentry bot reviewed Feb 27, 2026

View reviewed changes

src/sentry/preprod/models.py Show resolved Hide resolved

cursor bot reviewed Feb 27, 2026

View reviewed changes

src/sentry/preprod/api/endpoints/project_preprod_artifact_install_details.py Show resolved Hide resolved

ref(preprod): Restore Platform enum and use it in model property

f2744af

vercel bot deployed to Preview February 27, 2026 18:14 View deployment

ref(preprod): Mark ProjectPreprodInstallDetailsEndpoint as deprecated

12b6f00

vercel bot deployed to Preview February 27, 2026 19:11 View deployment

vercel bot deployed to Preview February 27, 2026 19:25 View deployment

trevor-e force-pushed the telkins/public-bd-apis-install-details branch from 8d99752 to 12b6f00 Compare February 27, 2026 20:03

ref(preprod): Use Platform enum values instead of string literals

c3f64ed

Compare against Platform.APPLE and Platform.ANDROID enum members instead of raw string literals for consistency and type safety. Co-Authored-By: Claude <noreply@anthropic.com>

vercel bot deployed to Preview February 27, 2026 20:17 View deployment

ref(preprod): Uppercase platform field in public API responses

637f58a

Uppercase the platform enum value in public endpoint responses for consistency with other enum fields like artifactType. Internal endpoints are unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

vercel bot deployed to Preview February 27, 2026 20:29 View deployment

ref(preprod): Rename install_info.py to installable_builds.py

7933478

Consolidate public build distribution response models into a single file, consistent with how size_analysis.py is organized.

vercel bot deployed to Preview February 27, 2026 21:18 View deployment

noahsmartin reviewed Feb 27, 2026

View reviewed changes

noahsmartin approved these changes Feb 27, 2026

View reviewed changes

trevor-e merged commit ad719dd into master Feb 27, 2026
75 of 76 checks passed

trevor-e deleted the telkins/public-bd-apis-install-details branch February 27, 2026 21:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(preprod): Add public install-details endpoint and shared utilities#109583

feat(preprod): Add public install-details endpoint and shared utilities#109583
trevor-e merged 6 commits intomasterfrom
telkins/public-bd-apis-install-details

trevor-e commented Feb 27, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 27, 2026

Uh oh!

Uh oh!

cursor bot left a comment

Uh oh!

Uh oh!

noahsmartin Feb 27, 2026

Uh oh!

trevor-e Feb 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

trevor-e commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

github-actions bot commented Feb 27, 2026

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

noahsmartin Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

trevor-e Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

trevor-e commented Feb 27, 2026 •

edited

Loading