POST http://localhost:8587/execute

# Trigger by agent name
curl -X POST http://localhost:8587/execute \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "incident_coordinator", "task": "Investigate the API timeout alert"}'

# Trigger by agent ID
curl -X POST http://localhost:8587/execute \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 21, "task": "Check system health"}'

curl -X POST http://localhost:8587/execute \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "cost_analyzer",
    "task": "Analyze costs for project",
    "variables": {"project_id": "prod-123", "region": "us-east-1"}
  }'

{
  "run_id": 120,
  "agent_id": 21,
  "agent_name": "incident_coordinator",
  "status": "running",
  "message": "Agent execution started"
}

{
  "error": "agent not found",
  "message": "No agent with name 'unknown_agent'"
}

export STN_WEBHOOK_API_KEY="your-secret-key"

curl -X POST http://localhost:8587/execute \
  -H "Authorization: Bearer your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent", "task": "Do something"}'

curl -X POST https://your-station:8587/execute \
  -H "Authorization: Bearer $STN_WEBHOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "incident_coordinator",
    "task": "PagerDuty alert: High CPU usage on payment-service"
  }'

# .github/workflows/deploy.yml
- name: Run deployment analyzer
  run: |
    curl -X POST ${{ secrets.STATION_URL }}/execute \
      -H "Authorization: Bearer ${{ secrets.STATION_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{
        "agent_name": "deployment_analyzer",
        "task": "Analyze deployment ${{ github.sha }}",
        "variables": {
          "commit": "${{ github.sha }}",
          "branch": "${{ github.ref_name }}"
        }
      }'

{
  "agent_name": "metrics_investigator",
  "task": "Investigate alert: {{alertTitle}} - {{alertScope}}",
  "variables": {
    "alert_id": "{{alertId}}",
    "severity": "{{alertPriority}}"
  }
}

# Slack sends: /investigate high memory on api-gateway

curl -X POST https://your-station:8587/execute \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "agent_name": "incident_coordinator",
    "task": "high memory on api-gateway"
  }'

# alertmanager.yml
receivers:
  - name: 'station'
    webhook_configs:
      - url: 'https://your-station:8587/execute'
        http_config:
          bearer_token: 'your-api-key'
        send_resolved: true

# Enable webhook (default: true)
export STN_WEBHOOK_ENABLED=true

# Disable webhook
export STN_WEBHOOK_ENABLED=false

# Set static API key for authentication
export STN_WEBHOOK_API_KEY="your-secret-key"

# config.yaml
webhook:
  enabled: true
  api_key: "{{ .STN_WEBHOOK_API_KEY }}"

# Via API
curl http://localhost:8585/api/v1/runs/120

# Via CLI
stn runs inspect 120

# Via MCP tool
"Inspect run 120"

# Poll until complete
while true; do
  status=$(curl -s http://localhost:8585/api/v1/runs/120 | jq -r '.status')
  if [ "$status" = "completed" ] || [ "$status" = "error" ]; then
    break
  fi
  sleep 2
done

Error: connection refused

Error: 401 Unauthorized

Error: agent not found

stn runs inspect <run_id>