Background Jobs

StorePush runs all Apple API operations as background jobs with real-time progress tracking.

How Jobs Work

When you trigger an action (like pushing metadata or syncing data), StorePush creates a job in a PostgreSQL-backed queue. Each app has its own dedicated queue to ensure operations are processed in order.

Job Lifecycle

Queued — Job is created and waiting to be processed
Processing — Job is actively running
Completed — Job finished successfully
Failed — Job encountered an error

Progress Tracking

Jobs report progress (0-100%) as they execute. You can monitor progress in real-time from the Tasks section of your app dashboard.

Job Types

Pull Operations

Pull All — Full sync of all app data (versions, metadata, builds, screenshots, reviews). Runs on initial app setup.
Pull Changes — Incremental sync that only fetches changes since the last pull. Runs automatically based on your configured interval.

Push Operations

Push Metadata — Sends metadata changes (descriptions, keywords, release notes) to Apple
Push Review — Sends review responses to Apple
Push Build — Submits a build to App Store Connect

AI Operations

Generate Metadata Translations — Translates metadata to AI-configured locales
Predict Analytics — Generates AI-powered performance predictions

Scheduled Jobs

Pull Changes — Runs per your configured interval (5/15/30 minutes)
Pull Analytics — Runs daily at 02:00 UTC
Predict Analytics — Runs weekly on Sundays at 03:00 UTC

Error Handling

Jobs have a maximum of 1 attempt — they do not automatically retry on failure. If a job fails:

The error message is stored and visible in the Tasks section
The job queue pauses to prevent cascading failures
You can review the error and retry manually

Token Management

Apple API tokens expire after 10 minutes. For long-running operations, StorePush automatically refreshes tokens before they expire and retries on authentication failures.