Documentation
API Version: v1
Getting Started
Learn how to make your first API call in under 5 minutes.
Prerequisites
Before you begin, you'll need:
- An Orchestraight account - Sign up here
- An API key from your API Console
Make Your First API Call
Generate a cold email with a single API call using cURL or any HTTP client:
Shell
curl -X POST "https://api.orchestraight.com/v1/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content_type": "cold_email",
"context": {
"sender": {
"company": "Your Company",
"value_proposition": "Your unique value proposition"
},
"prospect": {
"role": "VP of Sales",
"industry": "B2B SaaS"
},
"relationship": { "stage": "cold" },
"objective": "Book a discovery call"
}
}'Understanding the Response
A successful response includes the generated content and metadata:
JSON
{
"content": {
"subject_line": "Quick question about your sales process",
"body": "Hi [Name],\n\nI noticed your team is scaling rapidly...",
"word_count": 127
},
"metadata": {
"content_type": "cold_email",
"generated_at": "2025-01-15T10:30:00Z",
"optimization_score": 8,
"score_rationale": "Strong personalization and clear value prop."
}
}Response Times
The API generates content synchronously. Typical response times vary by content type:
| Content Type | Typical Response Time |
|---|---|
| Emails (cold, follow-up, payment reminder, etc.) | 10 - 12 seconds |
| Landing pages | 12 - 18 seconds |
| Objection handlers | 12 - 18 seconds |
| Coaching guidance | 30 - 50 seconds |
We recommend setting your HTTP client timeout to at least 60 seconds. The response_time_seconds field in the metadata reflects the server-side generation time.