Jobs

The owlmetry jobs command group lets you view, trigger, and cancel background jobs.

List Job Runs

owlmetry jobs list --team-id <id> --format json

Lists job runs for your team, ordered by creation time (newest first).

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

owlmetry jobs view <runId> --format json

Shows full details of a job run including status, duration, progress, parameters, result, and error (if failed).

owlmetry jobs trigger <jobType> --team-id <id> --project-id <id> --format json

Triggers a project-scoped job. The --project-id is required for project-scoped jobs like revenuecat_sync.

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

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> \
    --wait

Waiting for job to complete...
  [████████████░░░░░░░░] 120/200 Synced 98 users, 22 skipped

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> \
    --notify

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.

Ready to get started?

Install the CLI and let your agent handle the rest.