/v2/ai/generate-emailGenerates a full email from a prompt, no template needed. Charged at gpt-6-sol's rate (the fixed email-generation default) — model isn't selectable on this endpoint.
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
| Field | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | 1–10,000 characters. |
| tone | string | Optional | Up to 100 characters. Defaults to "Professional". |
| format | enum | Optional | visual | plain | html. Defaults to visual. |
| availableVariables | string[] | Optional | Merge-field names the AI is allowed to use (e.g. firstName, company), up to 100. |
curl -X POST "https://api.stynar.com/v2/ai/generate-email" \
-H "Authorization: Bearer esk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"prompt":"Cold email introducing our SOC 2 compliance product to security leads.","tone":"casual","availableVariables":["firstName","company"]}'{
"content": "Hi {{firstName}},\n\nQuick one — is {{company}} SOC 2 compliant yet?...",
"format": "visual",
"creditsCharged": 0.8
}| Status | Code | Meaning |
|---|---|---|
| ✕ 402 | QUOTA_EXCEEDED | Not enough credits. |
| ✕ 401 Unauthorized | UNAUTHORIZED | Missing, malformed, unknown, revoked, or expired key. |
| ✕ 403 Forbidden | API_ACCESS_DISABLED | API access is turned off for your account. |
| ✕ 403 Forbidden | INSUFFICIENT_SCOPE | The key doesn't have the scope this endpoint requires. |
| ✕ 404 Not Found | NOT_FOUND | Unknown route, or a resource that doesn't exist / isn't yours. |
| ✕ 409 Conflict | CONFLICT | The action can't be applied to the resource's current state. |
| ✕ 429 Too Many Requests | RATE_LIMIT_EXCEEDED | Per-minute or per-second limit hit. |
| ✕ 429 Too Many Requests | QUOTA_EXCEEDED | Monthly quota exhausted. |
| ✕ 500 Internal Server Error | INTERNAL_ERROR | Something broke on Stynar's end. |