The Waymaker One API

The Waymaker One API transforms strategic challenges into actionable business intelligence. Ask questions in natural language and receive refined strategic guidance with proven frameworks, competitive insights, and implementation roadmaps - all coordinated through a single, intelligent interface.

How It Works

Simple: Ask strategic questions in natural language
Intelligent: One analyzes your challenge and coordinates appropriate expertise
Valuable: Get refined strategic intelligence, not raw AI responses

POST /v1/coordinate

One endpoint. Strategic intelligence refined.

Request Format

Headers

HeaderRequiredDescription
AuthorizationYes*Bearer token from Waymaker authentication
apikeyYes*API key for external applications
Content-TypeYesMust be application/json
x-app-contextNoApplication identifier for internal apps

*Either Authorization or apikey is required

Request Body

interface StrategicRequest {
  messages: Array<{
    role: 'user' | 'assistant' | 'system';
    content: string;
  }>;
  userContext?: {
    industry?: string;
    businessStage?: 'startup' | 'growth' | 'enterprise';
    role?: string;
  };
  preferences?: {
    responseStyle?: 'concise' | 'detailed' | 'tactical';
    maxCredits?: number;
  };
  sessionId?: string;
}

Field Descriptions

messages (required)

Your strategic questions or challenges in natural language.

{
  "messages": [
    {
      "role": "user",
      "content": "Our startup is struggling with competitive positioning. How should we differentiate?"
    }
  ]
}

userContext (optional)

Business context that helps One provide more relevant strategic guidance.

{
  "userContext": {
    "industry": "financial_technology",
    "businessStage": "startup",
    "role": "founder"
  }
}

preferences (optional)

Controls the style and depth of strategic guidance.

{
  "preferences": {
    "responseStyle": "detailed",
    "maxCredits": 10
  }
}

sessionId (optional)

Maintains conversation context for multi-turn strategic planning sessions.

Response Format

Success Response

interface StrategicResponse {
  content: string;                    // Strategic guidance with implementation steps
  metadata: {
    sessionId: string;                // For conversation continuity
    strategicFocus: string;           // Primary strategic area addressed  
    frameworksApplied: string[];      // Waymaker methodologies used
    creditsUsed: number;              // Credit consumption
    confidenceScore: number;          // Quality confidence (0-100)
  };
  insights: {
    keyRecommendations: string[];     // Primary strategic recommendations
    implementationSteps: string[];    // Clear next actions
    successMetrics: string[];         // How to measure progress
    riskFactors?: string[];           // Potential challenges to consider
  };
  suggestions?: {
    followUpQuestions?: string[];     // Suggested deeper exploration
    relatedChallenges?: string[];     // Connected strategic issues
    nextMilestones?: string[];        // Future planning opportunities
  };
}

Example Response

{
  "content": "# Strategic Positioning Framework for Fintech Differentiation\n\nBased on your competitive positioning challenge, I recommend implementing a **Strategy Canvas** approach combined with competitive analysis to create clear differentiation...\n\n## Immediate Strategic Actions\n1. **Map Your Current Position**: Analyze factors you compete on today\n2. **Identify Blue Ocean Opportunities**: Find uncontested market spaces\n3. **Design Unique Value Curve**: Create differentiation that competitors can't easily copy\n\n## Implementation Roadmap\n**Week 1-2**: Competitive factor analysis and current state mapping\n**Week 3-4**: Blue ocean opportunity identification\n**Week 5-6**: New value proposition design and validation\n\n## Success Metrics\n- Clear positioning statement that differentiates from top 3 competitors\n- Unique value propositions that create competitive moats\n- Customer validation of differentiation factors\n\nThis strategic foundation will give you defensible positioning that drives customer acquisition and retention in the competitive fintech landscape.",
  
  "metadata": {
    "sessionId": "session_abc123",
    "strategicFocus": "competitive_positioning",
    "frameworksApplied": ["Strategy Canvas", "Competitive Analysis Canvas"],
    "creditsUsed": 5,
    "confidenceScore": 94
  },
  
  "insights": {
    "keyRecommendations": [
      "Implement Strategy Canvas methodology for systematic positioning analysis",
      "Focus on blue ocean opportunities rather than head-to-head competition",
      "Validate differentiation factors with target customers before market rollout"
    ],
    "implementationSteps": [
      "Conduct competitive factor analysis across top 5 fintech competitors",
      "Map your current strategic position on key competitive dimensions",
      "Identify 2-3 blue ocean opportunities for unique positioning",
      "Design and test unique value propositions with target segments"
    ],
    "successMetrics": [
      "Unique positioning statement completion",
      "Competitive differentiation score > 80%",
      "Customer validation rating > 4.0/5.0"
    ],
    "riskFactors": [
      "Differentiation factors must be defensible long-term",
      "Market validation required before major positioning shifts",
      "Competitive responses may require strategy adjustments"
    ]
  },
  
  "suggestions": {
    "followUpQuestions": [
      "Which specific fintech segments are you targeting for differentiation?",
      "What competitive advantages do you currently have that could be amplified?",
      "How do your target customers currently evaluate fintech solutions?"
    ],
    "relatedChallenges": [
      "Customer acquisition strategy optimization",
      "Product-market fit validation",
      "Go-to-market strategy development"
    ],
    "nextMilestones": [
      "Customer Journey Canvas for differentiated experience design",
      "Marketing strategy alignment with new positioning",
      "Sales enablement for competitive differentiation"
    ]
  }
}

Strategic Intelligence Processing

One automatically analyzes your challenge and coordinates the appropriate expertise:

Intelligent Analysis

  • Context Understanding: Business stage, industry, and role considerations
  • Challenge Classification: Strategic planning, competitive positioning, operational optimization
  • Methodology Selection: Optimal frameworks from 28+ Waymaker methodologies
  • Implementation Focus: Practical next steps and success metrics

Transparent Value Delivery

  • 1-3 Credits: Simple strategic questions and clarifications
  • 3-8 Credits: Framework-guided strategic planning
  • 8-15 Credits: Comprehensive multi-dimensional analysis
  • Response Time: 1-5 seconds for refined strategic intelligence

You don't choose tools - you get strategic performance refined into actionable guidance.

Error Responses

400 Bad Request

{
  "error": "bad_request",
  "message": "Invalid request format",
  "code": "INVALID_REQUEST_FORMAT",
  "details": {
    "field": "messages",
    "issue": "messages array is required"
  }
}

402 Payment Required

{
  "error": "payment_required",
  "message": "Insufficient credits for this operation",
  "code": "INSUFFICIENT_CREDITS",
  "details": {
    "creditsRequired": 5,
    "creditsAvailable": 2
  }
}

429 Rate Limited

{
  "error": "rate_limited",
  "message": "Rate limit exceeded for your tier",
  "code": "RATE_LIMIT_EXCEEDED",
  "details": {
    "resetTime": "2025-07-12T15:30:00Z",
    "tier": "platform"
  }
}

500 Internal Server Error

{
  "error": "internal_error",
  "message": "An unexpected error occurred",
  "code": "COORDINATION_FAILED",
  "details": {
    "requestId": "req_abc123"
  }
}

Usage Examples

Strategic Challenge

const response = await fetch('https://api.waymakerone.com/v1/coordinate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'Our customer acquisition costs are rising and we need a better competitive strategy'
    }],
    userContext: {
      industry: 'software',
      businessStage: 'growth', 
      role: 'ceo'
    }
  })
});

const result = await response.json();
console.log(result.insights.keyRecommendations); // Strategic recommendations with implementation steps

Customer Experience Challenge

const response = await fetch('https://api.waymakerone.com/v1/coordinate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'Our users are churning during onboarding. How can we improve retention?'
    }],
    userContext: {
      industry: 'saas',
      businessStage: 'growth'
    },
    preferences: {
      responseStyle: 'detailed'
    }
  })
});

Multi-Turn Strategic Planning

// Building comprehensive strategy over multiple interactions
const session1 = await fetch('https://api.waymakerone.com/v1/coordinate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'We need to develop our go-to-market strategy for a new product launch'
    }],
    userContext: {
      industry: 'fintech',
      businessStage: 'startup'
    }
  })
});

const sessionId = session1.metadata.sessionId;

// Follow up with specific implementation questions
const session2 = await fetch('https://api.waymakerone.com/v1/coordinate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [
      // Previous conversation context...
      {
        role: 'user',
        content: 'How should we prioritize our target customer segments?'
      }
    ],
    sessionId: sessionId
  })
});

Best Practices

Getting Maximum Strategic Value

  1. Provide Rich Context: Include industry, business stage, and role for more relevant guidance
  2. Ask Real Challenges: Focus on actual business problems rather than theoretical questions
  3. Use Conversational Sessions: Build comprehensive strategies through multi-turn planning
  4. Be Specific About Outcomes: Describe what success looks like for your situation

Strategic Intelligence Optimization

  1. Start with Core Challenges: Lead with your biggest strategic pain points
  2. Leverage Suggestions: Use follow-up questions and related challenges to deepen insights
  3. Implement Incrementally: Use the implementation steps and success metrics provided
  4. Track Progress: Monitor outcomes against the strategic recommendations

Integration Patterns

  1. Session Continuity: Maintain sessionId for comprehensive strategic planning
  2. Context Preservation: Provide userContext consistently for personalized guidance
  3. Credit Monitoring: Track usage patterns to optimize for strategic planning cycles
  4. Error Resilience: Build robust error handling for production strategic workflows

Next Steps