Skip to main content

SailPoint CLI

The CLI is a standalone terminal tool for interacting with your ISC tenant from the command line.

Install

macOS (Homebrew):

brew tap sailpoint-oss/tap
brew install sailpoint-cli

Windows: Download the latest .msi from the releases page. A pre-downloaded copy is at ./sail.exe in the repo root (v2.2.10).

Linux (Debian/Ubuntu):

sudo apt install ./sail_x.x.x_linux_amd64.deb

Linux (RHEL/Fedora):

sudo yum localinstall ./sail_x.x.x_linux_amd64.rpm

Configure

  1. Create an environment:

    sail env create myenv
  2. Set up authentication (choose one):

    OAuth (recommended):

    sail set auth oauth

    Personal Access Token:

    sail set pat
    # Enter your Client ID and Client Secret when prompted
    sail set auth pat
  3. Verify:

    sail transform list
    # or
    just transforms

Environment Variables (CI/CD)

VariableValue
SAIL_BASE_URLhttps://{tenant}.api.identitynow.com
SAIL_CLIENT_IDYour PAT Client ID
SAIL_CLIENT_SECRETYour PAT Client Secret

CLI vs SDK

Use the CLI when you want to...Use the SDK when you want to...
Run quick queries against your tenantBuild a custom application
Script simple automations in bashImplement complex workflows
Test API calls interactivelyIntegrate SailPoint into existing code
Manage transforms, connectors, etc.Handle errors and edge cases programmatically