Postman Collection Download

Download the complete UTMStack Alerts API Postman collection with pre-configured examples, authentication, and test scripts.

📦 UTMStack Alerts API - Postman Collection

Get started with the UTMStack API instantly by downloading our comprehensive Postman collection. This collection includes all API endpoints, authentication setup, example requests, and automated testing scripts.

🚀 One-Click Download

Download Complete Collection (JSON)
Ready-to-use Postman collection with all 9 API endpoints

📋 What's Included

🛠️ Import Instructions

1. Download the Collection

Click the download button above to save the JSON file to your computer

Alternative download link: UTMStack_Alerts_API.postman_collection.json

1. Open Postman

Launch the Postman application or visit web.postman.co for the web version

1. Import the Collection

• Click the "Import" button in Postman

  • Select "Upload Files" or drag and drop the JSON file

  • Choose the downloaded UTMStack_Alerts_API.postman_collection.json file

  • Click "Import" to add the collection to your workspace

1. Configure Variables

Set up the collection variables in Postman:

• baseUrl: https://your-utmstack-instance.com (replace with your actual URL)

• bearerToken: Leave empty (will be set automatically after authentication)

• alertId: c1c4e32c-dd9f-4a15-98c4-0dac2af40740 (sample alert ID for testing)

1. Authenticate

Run the "Authenticate User" request in the Authentication folder to get your JWT token

1. Start Testing

Explore all endpoints! The bearer token will be automatically applied to subsequent requests

📁 Collection Structure

The collection is organized into logical folders for easy navigation:

[Unknown component: details]

[Unknown component: details]

[Unknown component: details]

[Unknown component: details]

[Unknown component: details]

🎯 Pre-configured Examples

Each endpoint includes multiple real-world scenarios:

Authentication Examples

• ✅ Basic username/password authentication

• ✅ Token extraction and storage

• ✅ Error handling for invalid credentials

Alert Management Examples

• ✅ Search alerts by severity, status, time range

• ✅ Update status with observations

• ✅ Add tags with false positive rules

• ✅ Add investigation notes

Analytics Examples

• ✅ Get alert counts for dashboards

• ✅ Analyze severity distribution

• ✅ Export data for compliance reports

• ✅ Generate field statistics

Incident Management Examples

• ✅ Convert single high-priority alert

• ✅ Create incident from multiple related alerts

• ✅ Batch processing workflows

🧪 Automated Testing

Every request includes comprehensive test scripts that automatically verify:

Response Validation

    pm.test('Status code is 200', function () {
        pm.response.to.have.status(200);
    });

    pm.test('Response has valid structure', function () {
        const response = pm.response.json();
        pm.expect(response).to.have.property('data');
    });

Authentication Tests

    pm.test('Authentication successful', function () {
        const response = pm.response.json();
        pm.expect(response).to.have.property('id_token');
        pm.expect(response.authenticated).to.be.true;
        
        // Auto-store token for subsequent requests
        pm.collectionVariables.set('bearerToken', response.id_token);
    });

Data Integrity Tests

    pm.test('Alert data structure is valid', function () {
        const alerts = pm.response.json().body;
        pm.expect(alerts).to.be.an('array');
        
        alerts.forEach(alert => {
            pm.expect(alert).to.have.property('id');
            pm.expect(alert).to.have.property('name');
            pm.expect(alert).to.have.property('severity');
        });
    });

🔧 Environment Setup

Quick Setup Variables

Copy these variables into your Postman environment or collection variables:

{
  "baseUrl": "https://your-utmstack-instance.com",
  "bearerToken": "",
  "alertId": "c1c4e32c-dd9f-4a15-98c4-0dac2af40740",
  "username": "your_username",
  "password": "your_password"
}

Advanced Configuration

For enterprise environments, you can customize:

{
  "baseUrl": "https://utmstack-prod.company.com",
  "bearerToken": "",
  "alertId": "real-alert-id-from-your-system",
  "username": "api_user",
  "password": "secure_password",
  "timeout": 30000,
  "maxRetries": 3
}

{
  "baseUrl": "https://utmstack-dev.company.com",
  "bearerToken": "",
  "alertId": "test-alert-id",
  "username": "dev_user", 
  "password": "dev_password",
  "debugMode": true
}

{
  "baseUrl": "https://demo.utmstack.com",
  "bearerToken": "",
  "alertId": "demo-alert-id",
  "username": "demo_user",
  "password": "demo_password"
}

🚀 Quick Start Workflow

Once you've imported the collection, follow this workflow to get started:

1. Test Connection

Run Authentication → Authenticate User to verify your credentials and get a token

1. Explore Data

Run Alert Management → List Alerts to see your alerts data

1. Try Analytics

Run Analytics → Count Open Alerts to get dashboard metrics

1. Test Updates

Use Alert Management → Update Status to modify an alert

1. Export Data

Try Analytics → Export to CSV to generate reports

📚 Additional Resources

API Documentation

Complete API reference with detailed examples

Authentication Guide

Detailed JWT authentication documentation

Postman Learning Center

Learn Postman basics and advanced features

UTMStack Support

Get help with UTMStack and API issues

📞 Support

Need help with the Postman collection or API integration?

Note: Contact Support:

• 📧 Email: support@utmstack.com

• 📖 Documentation: UTMStack Docs

• 💬 Community: UTMStack Community Forums

📝 Version Information

[Unknown component: details]

[Unknown component: details]

[Unknown component: details]