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:
{
"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
- Log in to your Xynapse AI dashboard
- Navigate to Settings → API Keys
- Click Generate New Key
- Copy and securely store your key
Never expose your API key in client-side code or public repositories. Always use environment variables.
Using Your API Key
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
- In Xynapse, go to Integrations → Add Cloud
- Select Amazon Web Services
- Copy the provided CloudFormation template
- Deploy the template in your AWS account
- Enter the IAM Role ARN back in Xynapse
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
- Create an App Registration in Azure AD
- Assign Cost Management Reader role
- Generate a client secret
- 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
- Enable billing export to BigQuery
- Create a service account with BigQuery read access
- Download the JSON key file
- Upload the key in Xynapse integrations
API Overview
The Xynapse AI API allows you to programmatically access cost data, recommendations, and reports.
Base URL
https://api.xynapse.ai/v1
Response Format
All responses are returned in JSON format with the following structure:
{
"success": true,
"data": { ... },
"meta": {
"page": 1,
"total": 100
}
}
API Endpoints
Cost Data
/costs/summary
Get cost summary for a date range
/costs/breakdown
Get detailed cost breakdown by service
Recommendations
/recommendations
Get all optimization recommendations
/recommendations/:id/apply
Apply a specific recommendation
Alerts
/alerts
List all configured alerts
/alerts
Create a new alert
API Authentication
All API requests require authentication using API keys.
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
- 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