purchase commitments.md
Purchase Commitments
Use the Archera Partner API to programmatically purchase cloud commitments for your customers.
Prerequisites:
- Partner API key and partner organization ID
- Customer organization must be onboarded with cloud integration complete
- Customer billing data must be synced (typically 24-48 hours after onboarding)
Base URL: https://api.archera.ai/v2
Authentication: Include x-api-key: YOUR_PARTNER_API_KEY header in all requests.
Step 1: Get default commitment plans
Retrieve Archera’s recommended commitment plans for the customer:
curl -H 'x-api-key: YOUR_PARTNER_API_KEY' \
https://api.archera.ai/v2/org/{child_org_id}/partners/plans/default
Response includes:
- Recommended commitment amounts
- Projected savings
- Breakeven analysis
- Risk metrics
- Plan configurations
Review the plans to identify which commitment strategy works best for your customer.
Step 2: Purchase a commitment plan
Execute the purchase for a specific plan:
curl -X POST \
-H 'x-api-key: YOUR_PARTNER_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"plan_id": "plan_abc123",
"confirm": true
}' \
https://api.archera.ai/v2/org/{child_org_id}/partners/plans/purchase
Parameters:
plan_id- ID from the default plans responseconfirm- Set totrueto execute the purchase
The API will execute the commitment purchase in the customer’s cloud account.
What the API Enables
The Partner API provides:
- Archera recommendations for optimal commitment purchases based on usage patterns
- Programmatic purchasing without navigating cloud provider consoles
- Automated optimization that continuously finds savings opportunities
- White-label capabilities to embed in your platform
Use Cases
By integrating commitment purchasing into your platform, you can:
- Deliver enterprise-grade cloud cost optimization as a native feature
- Create new revenue streams while keeping customers in your ecosystem
- Automate savings recommendations and execution on a schedule
- Build dashboards showing ROI and lifetime savings to customers