Catalog Explorer

Discover available commands in SAP Automation Pilot dynamically via API.

Prerequisites

Environment variables must be set:

export AUTOPI_HOSTNAME="emea.autopilot.cloud.sap"
export AUTOPI_USERNAME="your-username"
export AUTOPI_PASSWORD="your-password"

API Operations

List All Catalogs

Discover what catalogs are available in the tenant.

# List all catalogs (SAP-provided + custom)
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/catalogs"

# List only SAP-provided catalogs (built-in)
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/catalogs?provided=true"

# List only custom/tenant catalogs
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/catalogs?own=true"

List Commands in a Catalog

CATALOG="applm-sapcp"
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/commands?catalog=$CATALOG"

Get Command Definition

COMMAND_ID="applm-sapcp:RestartCfApp:1"
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/commands/$COMMAND_ID"

Search Across Catalogs

Find commands matching a pattern.

# List all SAP-provided catalog IDs
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/catalogs?own=false"

# Search specific catalogs for commands matching a keyword
for catalog in applm-sapcp sm-sapcp cf-sapcp; do
  echo "=== $catalog ==="
  curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
    "https://$AUTOPI_HOSTNAME/api/v1/commands?catalog=$catalog"
done

Workflow: Complex Command Generation

When generating a command that involves multiple services:

1. User: "Create a command that restarts CF apps and checks SM bindings"

2. Discover relevant catalogs:
   - Query: GET /commands?catalog=applm-sapcp
   - Query: GET /commands?catalog=sm-sapcp

3. Find specific commands:
   - Found: applm-sapcp:RestartCfApp:1
   - Found: sm-sapcp:GetServiceBinding:1

4. Fetch definitions to understand parameters:
   - GET /commands/applm-sapcp:RestartCfApp:1
   - GET /commands/sm-sapcp:GetServiceBinding:1

5. Generate composite command using discovered executors

Error Handling

Related Skills

• automation-pilot-command-generation — Uses this skill for executor discovery
• automation-pilot-content-management-via-api — Deploy generated commands
• automation-pilot-executions-api — Run and monitor commands