Get the latest installable build for a project

GET /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/preprodartifacts/build-distribution/latest/

Get the latest installable build for a project.

Returns the latest installable build matching filter criteria. When buildVersion is provided, also returns the current build and whether an update is available.

Path Parameters

organization_id_or_slug (string) REQUIRED: The ID or slug of the organization the resource belongs to.
project_id_or_slug (string) REQUIRED: The ID or slug of the project the resource belongs to.

Query Parameters:

appId (string) REQUIRED: App identifier (exact match).
platform (string) REQUIRED: Platform: "apple" or "android".
buildVersion (string): Current build version. When provided, enables check-for-updates mode.
buildNumber (integer): Current build number. Either this or mainBinaryIdentifier must be provided when buildVersion is set.
mainBinaryIdentifier (string): UUID of the main binary (e.g. Mach-O UUID for Apple builds). Either this or buildNumber must be provided when buildVersion is set.
buildConfiguration (string): Filter by build configuration name (exact match).
codesigningType (string): Filter by code signing type.
installGroups (array(string)): Filter by install group name (repeatable for multiple groups).

Scopes

You need to authenticate via bearer auth token.

<auth_token> requires one of the following scopes:

project:distribution

Copied

curl https://sentry.io/api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/preprodartifacts/build-distribution/latest/ \
 -H 'Authorization: Bearer <auth_token>'

RESPONSESCHEMA

Copied
{
  "latestArtifact": {
    "buildId": "12345",
    "state": "PROCESSED",
    "appInfo": {
      "appId": "com.example.app",
      "name": "Example App",
      "version": "1.2.0",
      "buildNumber": 42,
      "artifactType": "AAB",
      "dateAdded": "2025-01-15T10:30:00+00:00",
      "dateBuilt": "2025-01-15T10:00:00+00:00"
    },
    "gitInfo": {
      "headSha": "abc123def456",
      "baseSha": "789xyz000111",
      "provider": "github",
      "headRepoName": "org/repo",
      "baseRepoName": "org/repo",
      "headRef": "feature-branch",
      "baseRef": "main",
      "prNumber": 42
    },
    "platform": "ANDROID",
    "projectId": "1",
    "projectSlug": "my-project",
    "buildConfiguration": "release",
    "isInstallable": true,
    "installUrl": "https://sentry.io/api/0/projects/org/project/files/installablepreprodartifact/abc123/?response_format=apk",
    "downloadCount": 5,
    "releaseNotes": "Bug fixes and performance improvements.",
    "installGroups": [
      "beta-testers"
    ],
    "isCodeSignatureValid": null,
    "profileName": null,
    "codesigningType": null
  },
  "currentArtifact": null
}

Was this helpful?