Jobs
View and manage background jobs from the Owlmetry CLI.
Background jobs are asynchronous server-side tasks with progress tracking, used for long-running operations like bulk data syncs. Only one instance of each job type per project can run at a time.
The owlmetry jobs command group lets you view, trigger, and cancel them.
List Job Runs
owlmetry jobs list --team-id <id> --format jsonLists job runs for your team, ordered by creation time (newest first).
Filters
| Flag | Description |
|---|---|
--type <type> | Filter by job type (e.g., revenuecat_sync) |
--status <status> | Filter by status: pending, running, completed, failed, cancelled |
--project-id <id> | Filter to a specific project |
--since <time> | Start time (e.g., 1h, 7d, or ISO 8601) |
--until <time> | End time |
--limit <n> | Max entries to return |
--cursor <cursor> | Pagination cursor from previous response |
View Job Details
owlmetry jobs view <runId> --format jsonShows full details of a job run including status, duration, progress, parameters, result, and error (if failed).
Trigger a Job
owlmetry jobs trigger <jobType> --team-id <id> [--project-id <id>] [--param key=value ...] [--wait] [--notify] [--format json]Triggers a background job. The --project-id flag is required for project-scoped jobs like revenuecat_sync, and can be omitted for team-scoped jobs.
Options
| Flag | Description |
|---|---|
--project-id <id> | Project ID (required for project-scoped jobs) |
--param key=value | Job parameter (repeatable) |
--notify | Get email notification on completion or failure |
--wait | Wait for the job to finish, showing a live progress bar |
Wait for completion
The --wait flag polls the job every 2 seconds and shows a live progress bar:
owlmetry jobs trigger revenuecat_sync \
--team-id <id> \
--project-id <id> \
--waitWaiting for job to complete...
[████████████░░░░░░░░] 120/200 Synced 98 users, 22 skippedEmail notification
The --notify flag sends an email to your authenticated email address when the job finishes:
owlmetry jobs trigger revenuecat_sync \
--team-id <id> \
--project-id <id> \
--notifyCancel a Job
owlmetry jobs cancel <runId>Cancels a running job. The job handler checks for cancellation cooperatively and returns early. Only works on jobs with status running.