Skip to main content

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:

POST /v1/generate

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)
POST /v1/coach

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

TypeScript
// 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

TypeScript
// 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 TypeDescription
cold_emailFirst outreach to prospects
follow_up_emailContinue conversations
sales_scriptCall scripts and talk tracks (coming soon)
landing_pageConversion-focused page copy
objection_handlerResponses to common objections
proposal_coverProposal cover letters
meeting_confirmationConfirm and prep for meetings
partnership_outreachPartner and alliance outreach
investor_outreachFundraising and investor emails

Customer Retention

Content TypeDescription
renewal_requestContract renewal outreach
contract_renewalFormal renewal proposals
win_back_campaignRe-engage churned customers
churn_preventionProactive retention outreach
upsell_cross_sellExpansion opportunities
reactivation_offerIncentives to return

Customer Engagement

Content TypeDescription
referral_requestAsk for referrals
testimonial_requestGather social proof
review_requestRequest reviews
survey_requestFeedback collection
onboarding_sequenceNew customer welcome
loyalty_programReward program messaging
event_invitationWebinar and event invites

Collections

Content TypeDescription
payment_reminderFriendly payment reminders
past_due_noticeOverdue account notices
collections_scriptPhone collection scripts (coming soon)
payment_arrangementPayment plan offers
final_noticeLast chance notices

Sensitive Communications

Content TypeDescription
price_increaseCommunicate price changes
service_discontinuationEOL announcements
policy_changePolicy update notifications
decline_or_rejectionSaying no professionally
bad_news_deliveryDeliver difficult news
apology_recoveryService recovery messages

B2C Marketing

Content TypeDescription
promotional_emailMarketing promotions
cart_abandonmentCart 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.

Next Steps