API Version: v1
Core Concepts
Understand the key concepts behind the Orchestraight API.
Generate vs Coach: Two Ways to Create Content
Orchestraight offers two endpoints for content creation, each serving different use cases:
Generate Endpoint
Returns finished, ready-to-use content. Perfect when you want Orchestraight to handle the entire generation process.
Best for:
- Quick content generation
- Applications without their own AI infrastructure
- When you want optimized, battle-tested output
- Prototyping and MVPs
Returns:
- Complete content (subject lines, body text)
- Metadata with optimization score (1-10)
Coach Endpoint
Returns prompts, templates, and guidance for generating content with your own AI systems.
Best for:
- Teams with existing AI infrastructure
- Custom fine-tuned models
- When you need more control over generation
- Cost optimization at scale
Returns:
- System prompt (persona + guidelines)
- User prompt (complete generation instruction)
- Content type metadata
Generate Example
// Generate returns finished, ready-to-use content
const response = await client.coldEmail.generate({
context: {
sender: { company: "Acme Inc", value_proposition: "AI sales tools" },
prospect: { role: "VP Sales", industry: "SaaS" },
relationship: { stage: "cold" },
objective: "Book a discovery call",
},
});
// Response contains the actual content
console.log(response.content.subject_line);
// → "Quick question about your sales process"
console.log(response.content.body);
// → "Hi [Name], I noticed your team is scaling..."Coach Example
// Coach returns prompts and guidance for your own AI
const response = await client.coldEmail.coach({
context: {
sender: { company: "Acme Inc", value_proposition: "AI sales tools" },
prospect: { role: "VP Sales", industry: "SaaS" },
relationship: { stage: "cold" },
objective: "Book a discovery call",
},
});
// Response contains prompts you can use with any LLM
console.log(response.coaching.system_prompt);
// → "You are a neurostrategy-trained cold email specialist..."
console.log(response.coaching.user_prompt);
// → "Write a cold email for Acme Inc targeting VP Sales..."
console.log(response.coaching.content_type);
// → "cold_email"
// Use with your own AI
const my_content = await myLLM.generate({
system: response.coaching.system_prompt,
user: response.coaching.user_prompt,
});Which should I use?
Start with Generate for simplicity. Switch to Coach when you need more control, want to use your own models, or are optimizing costs at high volume.
Content Types
Both endpoints support the same content types. Specify the type in your request to get optimized output for that format:
Sales & Business Development
| Content Type | Description |
|---|---|
cold_email | First outreach to prospects |
follow_up_email | Continue conversations |
sales_script | Call scripts and talk tracks (coming soon) |
landing_page | Conversion-focused page copy |
objection_handler | Responses to common objections |
proposal_cover | Proposal cover letters |
meeting_confirmation | Confirm and prep for meetings |
partnership_outreach | Partner and alliance outreach |
investor_outreach | Fundraising and investor emails |
Customer Retention
| Content Type | Description |
|---|---|
renewal_request | Contract renewal outreach |
contract_renewal | Formal renewal proposals |
win_back_campaign | Re-engage churned customers |
churn_prevention | Proactive retention outreach |
upsell_cross_sell | Expansion opportunities |
reactivation_offer | Incentives to return |
Customer Engagement
| Content Type | Description |
|---|---|
referral_request | Ask for referrals |
testimonial_request | Gather social proof |
review_request | Request reviews |
survey_request | Feedback collection |
onboarding_sequence | New customer welcome |
loyalty_program | Reward program messaging |
event_invitation | Webinar and event invites |
Collections
| Content Type | Description |
|---|---|
payment_reminder | Friendly payment reminders |
past_due_notice | Overdue account notices |
collections_script | Phone collection scripts (coming soon) |
payment_arrangement | Payment plan offers |
final_notice | Last chance notices |
Sensitive Communications
| Content Type | Description |
|---|---|
price_increase | Communicate price changes |
service_discontinuation | EOL announcements |
policy_change | Policy update notifications |
decline_or_rejection | Saying no professionally |
bad_news_delivery | Deliver difficult news |
apology_recovery | Service recovery messages |
B2C Marketing
| Content Type | Description |
|---|---|
promotional_email | Marketing promotions |
cart_abandonment | Cart recovery emails |
See the Types Reference for the complete list of all 35 content types.
Neurostrategy Techniques
Orchestraight uses research-backed psychological techniques to create persuasive content. These techniques are baked into the generated output automatically.
Pattern Interrupt
Opens with something unexpected to break through mental filters and capture attention.
Psychological Alignment
Establishes common ground and shared values to build rapport quickly.
Cognitive Tension
Creates a gap between current state and desired state that motivates action.
Curiosity Gap
Hints at valuable information without revealing everything, compelling the reader to engage.
Analysis coming soon
Detailed neurostrategy analysis (techniques used, psychological triggers, and effectiveness scores) will be available via the upcoming /v1/analyze endpoint.