Skip to main content

Overview

The Generations API creates AI-powered content using pre-built templates with optional brand voice styling. Generate blog posts, social media content, email campaigns, and more.

Available Templates

Browse available generation apps:
import requests

response = requests.get(
    "https://app.mavera.io/api/v1/generation-apps",
    headers={"Authorization": "Bearer mvra_live_your_key_here"}
)

apps = response.json()["data"]
for app in apps:
    print(f"{app['name']}: {app['description']}")

Creating Content

response = requests.post(
    "https://app.mavera.io/api/v1/generations",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "app_id": "blog_post_generator",
        "title": "Q1 Product Launch Blog",
        "brand_voice_id": "bv_abc123",  # Optional
        "input_data": {
            "topic": "New Product Features",
            "target_audience": "Small business owners",
            "tone": "professional yet approachable",
            "length": "1000 words"
        },
        "workspace_id": "your_workspace_id"
    }
)

generation = response.json()
print(f"Content:\n{generation['output']}")

Response Format

{
  "id": "gen_abc123",
  "title": "Q1 Product Launch Blog",
  "app": "blog_post_generator",
  "output": "# Introducing Our Latest Features\n\nWe're excited to announce...",
  "markdown": "# Introducing Our Latest Features...",
  "content_type": "MARKDOWN",
  "usage": {
    "credits_used": 15
  }
}

List Generations

curl https://app.mavera.io/api/v1/generations \
  -H "Authorization: Bearer mvra_live_your_key_here"

Delete a Generation

curl -X DELETE https://app.mavera.io/api/v1/generations/gen_abc123 \
  -H "Authorization: Bearer mvra_live_your_key_here"

API Reference

See the full API specification