Introduction

Welcome to Xynapse AI documentation. Learn how to integrate our AI-powered cloud cost optimization platform with your infrastructure.

What is Xynapse AI?

Xynapse AI is an AI-powered cloud pricing intelligence platform that helps enterprises optimize their multi-cloud spending. Our platform analyzes usage patterns across AWS, Azure, and GCP to provide actionable cost optimization recommendations.

Key Features

  • Multi-Cloud Analytics - Unified visibility across all major cloud providers
  • AI Recommendations - Machine learning-powered optimization suggestions
  • Real-Time Monitoring - Instant alerts for anomalies and budget overruns
  • Cost Forecasting - Predict future spending with AI-driven models

Quick Start

Get up and running with Xynapse AI in just a few minutes.

Step 1: Create an Account

Sign up for a free trial at xynapse.ai. No credit card required.

Step 2: Connect Your Cloud

Navigate to Settings → Integrations and connect your first cloud provider. We support:

  • Amazon Web Services (AWS)
  • Microsoft Azure
  • Google Cloud Platform (GCP)

Step 3: Configure Read-Only Access

For security, we only require read-only access to your billing and usage data. Follow our provider-specific guides:

AWS IAM Policy
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ce:GetCostAndUsage",
                "ce:GetReservationUtilization",
                "ce:GetSavingsPlansUtilization",
                "ec2:DescribeInstances",
                "rds:DescribeDBInstances"
            ],
            "Resource": "*"
        }
    ]
}

Step 4: View Recommendations

Once connected, our AI engine will analyze your data and provide recommendations within 24 hours. You'll receive an email when your first insights are ready.

Authentication

Xynapse AI uses API keys for authentication. Each request must include your API key in the header.

Getting Your API Key

  1. Log in to your Xynapse AI dashboard
  2. Navigate to Settings → API Keys
  3. Click Generate New Key
  4. Copy and securely store your key
⚠️ Security Warning

Never expose your API key in client-side code or public repositories. Always use environment variables.

Using Your API Key

Request Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

AWS Integration

Connect your AWS accounts to start analyzing costs and receiving optimization recommendations.

Prerequisites

  • AWS Account with billing access
  • IAM permissions to create roles
  • Cost Explorer enabled in your account

Setup Process

  1. In Xynapse, go to Integrations → Add Cloud
  2. Select Amazon Web Services
  3. Copy the provided CloudFormation template
  4. Deploy the template in your AWS account
  5. Enter the IAM Role ARN back in Xynapse
CloudFormation Stack
aws cloudformation create-stack \
  --stack-name XynapseAI-Integration \
  --template-url https://xynapse.ai/cf-template.yaml \
  --capabilities CAPABILITY_IAM

Azure Integration

Connect your Microsoft Azure subscriptions for comprehensive cost analysis.

Prerequisites

  • Azure subscription with Reader access
  • Azure AD permissions to create app registrations

Setup Process

  1. Create an App Registration in Azure AD
  2. Assign Cost Management Reader role
  3. Generate a client secret
  4. Enter credentials in Xynapse dashboard

GCP Integration

Connect Google Cloud Platform projects for multi-cloud visibility.

Prerequisites

  • GCP Project with billing enabled
  • BigQuery dataset for billing export

Setup Process

  1. Enable billing export to BigQuery
  2. Create a service account with BigQuery read access
  3. Download the JSON key file
  4. Upload the key in Xynapse integrations

API Overview

The Xynapse AI API allows you to programmatically access cost data, recommendations, and reports.

Base URL

Base URL
https://api.xynapse.ai/v1

Response Format

All responses are returned in JSON format with the following structure:

Success Response
{
    "success": true,
    "data": { ... },
    "meta": {
        "page": 1,
        "total": 100
    }
}

API Endpoints

Cost Data

GET /costs/summary

Get cost summary for a date range

GET /costs/breakdown

Get detailed cost breakdown by service

Recommendations

GET /recommendations

Get all optimization recommendations

POST /recommendations/:id/apply

Apply a specific recommendation

Alerts

GET /alerts

List all configured alerts

POST /alerts

Create a new alert

API Authentication

All API requests require authentication using API keys.

Example Request
curl -X GET "https://api.xynapse.ai/v1/costs/summary" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Rate Limits

API requests are rate limited to ensure fair usage.

Plan Requests/Minute Requests/Day
Starter 60 10,000
Professional 300 100,000
Enterprise Unlimited Unlimited

Cost Optimization Guide

Learn how to maximize savings with Xynapse AI recommendations.

Types of Recommendations

  • Reserved Instances - Commit to long-term usage for discounts
  • Rightsizing - Match instance sizes to actual usage
  • Idle Resources - Identify and terminate unused resources
  • Savings Plans - Flexible discount programs

Implementing Recommendations

Each recommendation includes:

  • Estimated monthly savings
  • Implementation steps
  • Risk assessment
  • One-click apply (where supported)

Setting Up Alerts

Configure alerts to stay informed about cost anomalies and budget thresholds.

Alert Types

  • Budget Alerts - Notify when spending exceeds thresholds
  • Anomaly Detection - AI-detected unusual spending patterns
  • Recommendation Alerts - New optimization opportunities

Notification Channels

  • Email
  • Slack
  • Microsoft Teams
  • Webhooks
  • PagerDuty

Custom Reports

Create and schedule custom reports for stakeholders.

Report Types

  • Executive Summary - High-level cost overview for leadership
  • Department Breakdown - Costs by team or cost center
  • Savings Report - Track implemented optimizations
  • Forecast Report - Predicted future spending

Scheduling

Reports can be scheduled for automatic delivery:

  • Daily at 9 AM
  • Weekly on Mondays
  • Monthly on the 1st
  • Custom cron schedules