Aura++ developer docs
Aura++ Partner Premium Submit API
Use this API so your form (e.g. aidirectori.es) can book Premium launches on Aura++ under your account — same rules as Bulk / Premium Launcher in the dashboard. Machine readable OpenAPI: /openapi.json.
How it works
- You authenticate with your Premium Launcher license key.
- Your form asks Aura++ which Premium dates are still free for your account.
- When a customer submits, you send their project details + chosen date. We create the project under your Aura++ account and schedule a Premium launch (no Stripe payment — covered by your license).
- Confirmation emails go to you and the customer (
customerEmail).
Rules (same as your dashboard)
- 1 launch per day per Aura++ account
- Shared global Premium pool (limited slots per day across the platform)
- Book dates 1–60 days ahead · launches at 08:00 UTC
- Premium only (not Premium Plus)
- Host logo & product images yourself (HTTPS URLs only — no upload API)
1.One-time setup
- Sign in to the Aura++ account that should own the launches.
- Open Dashboard → Bulk and link your Premium Launcher license key.
- Keep that key private. Your form will send it as
Authorization: Bearer …on every request.
Base URL: https://auraplusplus.com/api/partner/v1
2.Load categories (for your form dropdown)
Call this once (you can cache the list). Map labels in your UI to the id values — submit needs 1–3 IDs.
GET https://auraplusplus.com/api/partner/v1/categories
Authorization: Bearer YOUR_LICENSE_KEY3.Show available Premium dates
Returns only dates your account can still book (global slots left and you haven’t used your 1/day yet).
GET https://auraplusplus.com/api/partner/v1/availability
Authorization: Bearer YOUR_LICENSE_KEY
Optional: ?from=2026-09-01&to=2026-09-30Response includes dates like { "date": "2026-09-01", "available": true, "premiumSlotsRemaining": 7 }. After you book a day, refresh availability so that day disappears for you.
4.Submit the customer’s project
Send the form fields + the date they picked. Description must be at least 200 words.
POST https://auraplusplus.com/api/partner/v1/projects
Authorization: Bearer YOUR_LICENSE_KEY
Content-Type: application/json
{
"customerEmail": "customer@example.com",
"name": "Example AI",
"websiteUrl": "https://example.com",
"description": "(200+ words)",
"logoUrl": "https://cdn.example.com/logo.png",
"productImageUrl": "https://cdn.example.com/product.png",
"categories": ["<category-id-from-step-2>"],
"techStack": ["Next.js", "TypeScript"],
"platforms": ["web"],
"pricing": "freemium",
"pricingDetails": "Free + Pro from $29/mo",
"makerName": "Jane Doe",
"launchDate": "2026-09-01"
}Optional fields: githubUrl, twitterUrl.platforms: web, mobile, desktop, api, other (at least one).pricing: free, freemium, or paid — if not free, include pricingDetails.
On success you get projectId, slug, launchDate, and projectUrl — show that URL to the customer.
If something fails
| Code | Meaning |
|---|---|
| 401 | License missing, not linked, invalid, or expired |
| 400 | Bad fields (short description, wrong categories, invalid JSON, etc.) |
| 409 | Date full, you already booked that day, or website URL already exists |
Suggested form flow
- Load categories once when the form opens.
- Load availability when the user opens the date picker.
- On submit → POST projects → show success + project link.
- Reload availability after a successful booking.