Retrieve latest base Snapshot

GET /api/0/organizations/{organization_id_or_slug}/preprodartifacts/snapshots/latest-base/

Retrieve the most recent base snapshot for a given app.

A base snapshot is one uploaded without a base_sha (i.e., a snapshot from a base branch like main). Use the optional branch and project parameters to narrow the search.

The response includes the full image list with download URLs. Use compact_metadata=1 to reduce image metadata.

This endpoint requires a bearer token with project:read access.

Path Parameters

organization_id_or_slug (string)
REQUIRED

The ID or slug of the organization the resource belongs to.

Query Parameters:

app_id (string)
REQUIRED

App identifier to match.

branch (string)

Git branch name to filter on.

project (integer)

Project ID to scope the lookup.

compact_metadata (string)

Set to '1' or 'true' to strip image metadata to display_name, image_file_name, group, description, and image_url only.

Scopes

<auth_token> requires one of the following scopes:
  • org:ci
  • project:admin
  • project:read
  • project:releases
  • project:write
Copied
curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/preprodartifacts/snapshots/latest-base/ \
 -H 'Authorization: Bearer <auth_token>'
RESPONSESCHEMA
Copied
{
  "head_artifact_id": "99",
  "project_id": "1",
  "project_slug": "my-project",
  "app_id": "com.example.app",
  "image_count": 2,
  "images": [
    {
      "key": "a1b2c3d4e5f6",
      "display_name": "Home Screen",
      "group": "iPhone 15",
      "image_file_name": "home_screen_iphone15.png",
      "width": 1170,
      "height": 2532,
      "image_url": "/api/0/projects/org-slug/my-project/files/images/a1b2c3d4e5f6/"
    }
  ],
  "diff_threshold": 0.01,
  "date_added": "2025-01-15T10:30:00+00:00",
  "vcs_info": {
    "head_sha": "abc123def456",
    "base_sha": null,
    "head_ref": "main",
    "base_ref": null,
    "head_repo_name": "org/repo",
    "pr_number": null
  }
}
Was this helpful?