CLI (uptimyctl)

Manage incidents, maintenance windows, healthchecks, and workspace configuration from the command line.

Overview

uptimyctl is a command-line tool for managing your upti.my workspace. It provides full CRUD access to incidents, maintenance windows, healthchecks, and applications. It also supports exporting and importing your workspace configuration for infrastructure-as-code workflows.

Source code and releases are available at github.com/uptimy/uptimyctl.

Installation

Install uptimyctl using one of the following methods.

Quick Install (curl)

install.sh

curl -sSfL https://raw.githubusercontent.com/uptimy/uptimyctl/master/scripts/install.sh | sudo bash

Go Install

go-install.sh

go install github.com/uptimy/uptimyctl@latest

Build from Source

build.sh

git clone https://github.com/uptimy/uptimyctl.git
cd uptimyctl
go build -o uptimyctl .

Authentication

uptimyctl supports three ways to provide your API key, listed in order of precedence.

Method	Details
Flag	`--api-key YOUR_KEY` on any command
Environment variable	`UPTIMYCTL_API_KEY=YOUR_KEY`
Config file	`~/.config/uptimyctl/config.yaml` (created by `uptimyctl auth login`)

interactive-login.sh

uptimyctl auth login

Commands Reference

Applications

applications.sh

uptimyctl applications list
uptimyctl applications get <uuid>

Healthchecks

healthchecks.sh

uptimyctl healthchecks list
uptimyctl healthchecks get <uuid>
uptimyctl healthchecks trigger <uuid>
uptimyctl healthchecks pause <uuid>
uptimyctl healthchecks resume <uuid>

Incidents

incidents.sh

uptimyctl incidents list
uptimyctl incidents get <uuid>
uptimyctl incidents create --title "API outage" --severity critical --public
uptimyctl incidents update <uuid> --status investigating
uptimyctl incidents add-update <uuid> --message "Root cause identified"
uptimyctl incidents resolve <uuid>
uptimyctl incidents stats

Maintenance Windows

maintenance.sh

uptimyctl maintenances list
uptimyctl maintenances create --title "DB migration" --description "Scheduled database migration" --start-at "2026-03-01T02:00:00Z" --finish-at "2026-03-01T04:00:00Z"
uptimyctl maintenances update <uuid> --title "DB migration (extended)"
uptimyctl maintenances start <uuid>
uptimyctl maintenances resolve <uuid>
uptimyctl maintenances cancel <uuid>
uptimyctl maintenances delete <uuid>

Schedulers (Regions)

schedulers.sh

uptimyctl schedulers list
uptimyctl schedulers get <uuid>

Export & Import

Export your entire workspace configuration to a JSON file and import it into another workspace. This is useful for promoting configuration from staging to production or for backup purposes.

export-import.sh

uptimyctl export -f config.json
uptimyctl import config.json

Output Formats

By default, uptimyctl outputs results in a human-readable table format. Use -o json for machine-readable JSON output.

json-output.sh

uptimyctl incidents list -o json

CI/CD Integration

Use uptimyctl in your deployment pipelines to create maintenance windows before deploys and resolve them afterward. This suppresses false alerts during expected downtime.

.github/workflows/deploy.yml

- name: Start maintenance window
  id: maintenance
  run: |
    uptimyctl maintenances create \
      --title "Deploy ${{ github.sha }}" \
      --description "Automated deployment maintenance window" \
      --start-at "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
      --finish-at "$(date -u -d '+30 minutes' +%Y-%m-%dT%H:%M:%SZ)"
  env:
    UPTIMYCTL_API_KEY: ${{ secrets.UPTIMYCTL_API_KEY }}

- name: Deploy application
  run: ./deploy.sh

- name: Resolve maintenance window
  run: uptimyctl maintenances resolve ${{ steps.maintenance.outputs.id }}
  env:
    UPTIMYCTL_API_KEY: ${{ secrets.UPTIMYCTL_API_KEY }}

💡 Config Management

Use uptimyctl export and uptimyctl import for Terraform-style config management. Export from production, review changes, and import into staging or new workspaces.

Configuration

The config file is stored at ~/.config/uptimyctl/config.yaml and is created automatically by uptimyctl auth login. Environment variables and flags override config file values.

~/.config/uptimyctl/config.yaml

api_key: upt_your-api-key-here
api_url: https://api.upti.my
incidents_api_url: https://workflows.upti.my

API keys start with the upt_ prefix. Incidents and maintenance windows are served by the workflows service at incidents_api_url. Output format is controlled with the -o flag, not the config file.