sentry-cli preprod snapshots upload adds VCS parameters
Introduced 2026-03-10 · score 0.94
HOW TO USE IT
When uploading preprod snapshots, use `build snapshots upload` and provide VCS metadata with the documented flags; the command also supports automatic metadata collection in most CI environments.
sentry-cli build snapshots upload --org <org> --project <project> <path> --app-id <app-id> --head-sha <head-sha> --base-sha <base-sha> --vcs-provider <provider> --head-repo-name <owner/repo> --base-repo-name <owner/repo> --head-ref <branch> --base-ref <branch> --pr-number <number>sentry-cli build snapshots upload --org <org> --project <project> <path> --app-id <app-id>WHY THIS HELPS
Upload preprod build snapshots with VCS metadata from a coding repository.
REQUIREMENTS AND LIMITATIONS
- Version: 3.3.2
- Availability: preprod
- PATH (required): Folder containing images to upload.
- --app-id APP_ID (required): Application identifier.
- --org ORG / --project PROJECT: Organization ID/slug and project ID/slug; command resolves them from configuration if omitted.
- --head-sha SHA: VCS commit SHA; defaults to current commit.
- --base-sha SHA: Base VCS commit SHA; defaults to merge base of current and remote branch.
- --vcs-provider PROVIDER: VCS provider; defaults to current provider.
- --head-repo-name NAME: Head git repository name, e.g. `organization/repository`; defaults to current repository.
- --base-repo-name NAME: Base git repository name, e.g. `organization/repository`; defaults to current repository.
- --head-ref REF: Head branch/reference; defaults to current reference.
- --base-ref REF: Base branch/reference; defaults to merge base with remote tracking branch.
- --pr-number NUMBER: Pull request number; auto-detected in GitHub Actions pull_request workflows when omitted.
- --force-git-metadata: Force collection and sending of git metadata; conflicts with `--no-git-metadata`.
- --no-git-metadata: Disable collection and sending of git metadata; conflicts with `--force-git-metadata`.
- Prerequisite: Authenticate with a Sentry CLI configuration/token and select an organization and project; organization/project may come from config.
- Prerequisite: The command is marked experimental and may have breaking changes or be removed in any Sentry CLI release.
FIRST-PARTY EVIDENCE
- https://github.com/getsentry/sentry-cli/releases/tag/3.3.2
- https://github.com/getsentry/sentry-cli/pull/3200
- https://github.com/getsentry/sentry-cli/blob/3.3.2/src/commands/build/snapshots.rs
- https://github.com/getsentry/sentry-cli/blob/3.3.2/src/utils/args.rs
Check the installed version and the source before using it. Entry JSON