Quick Start Guide

Prerequisites

Before you begin, ensure you have the following ready. StackFlow is a cloud-hosted SaaS platform — there is no software to install on your local machine. You need a modern browser (Chrome 120+, Firefox 120+, or Safari 17+) and credentials provisioned by your StackFlow administrator.

Step 1: Access the Portal

Navigate to your organization's StackFlow portal at https://<your-instance>.stackflow-tech.com. You will be redirected to the Cognito hosted UI for authentication. Enter your email and temporary password, then set a permanent password when prompted.

# Verify your instance URL is reachable
curl -I https://<your-instance>.stackflow-tech.com/prod/api/health
# Expected: HTTP/2 200

# The Cognito hosted UI is at:
# https://stackflow-identity-373544523367.auth.us-east-1.amazoncognito.com

After successful authentication, you will land on the StackFlow home dashboard. The top navigation bar shows your organization name, and the left sidebar displays the modules your role has access to.

Step 2: Create Your First Incident

Click ITSM → Incidents → New Incident in the left sidebar. The new incident form will open with AI-assisted fields. As you type in the short description, the AI engine will suggest a category, priority, and assignment group based on similar past incidents.

# Or create via the REST API:
curl -X POST https://<your-instance>.stackflow-tech.com/prod/api/incidents   -H "Authorization: Bearer $TOKEN"   -H "Content-Type: application/json"   -d '{
    "short_description": "Database connection timeout in production",
    "priority": "P2",
    "category": "database",
    "assignment_group": "Platform Engineering"
  }'

The incident will be assigned an INC number (e.g., INC0001234) and routed to the appropriate assignment group. SLA timers start immediately based on the priority and configured SLA policies.

Step 3: Configure AI Copilot

The AI Copilot sidebar is accessible from any page by clicking the robot icon in the top-right corner. On first use, the copilot will query the Bedrock Knowledge Base (BXJGG7PIPS) to index your organization's knowledge articles. This process typically takes 2-5 minutes for up to 10,000 articles.

Step 4: Set Up Notifications

Navigate to Admin → System Properties → Notifications to configure the default notification channels. StackFlow uses Amazon SES for email delivery and SNS for system-level alerts. Configure the sender email (must be verified in SES) and set up at least one recipient group for P1 incidents.

{
  "notification_channels": {
    "email": {
      "provider": "ses",
      "from_address": "itsm@<your-instance>.stackflow-tech.com",
      "reply_to": "support@<your-org>.com"
    },
    "sla_alerts": {
      "sns_topic": "stackflow-sla-alerts",
      "breach_warning_threshold_pct": 75
    }
  }
}

Next Steps

You now have a working StackFlow environment. Here are the recommended next steps based on your role: