API Documentation

Enterprise-grade AI content generation powered by multi-agent LangGraph workflows. Production-ready REST API with 100+ templates and 60+ style profiles.

https://api.writerzroom.com/v1

Authentication

All API requests require a Bearer token supplied in the Authorization header. Generate your API key from Settings → API Access. Store keys in environment variables — never in client-side code or public repositories.

Step 1

Generate an API Key

Go to Settings → API Access, click Generate New Key, and copy it immediately. It will not be shown again.

Step 2

Include it in Every Request

curl -X POST https://api.writerzroom.com/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "blog_article_generator",
    "style_profile_id": "general_blog",
    "inputs": { "topic": "AI in enterprise content" }
  }'

Security Note

API access is available on Professional and Enterprise plans. Rotate keys immediately if you suspect exposure. Requests using invalid or missing keys return HTTP 401.

API Endpoints

POST/generate
GenerationAuth

Submit a generation request and receive a request_id for polling

GET/generate/status/{request_id}
GenerationAuth

Poll generation status and retrieve completed content

GET/content
ContentAuth

List all saved content for the authenticated user

GET/content/{contentID}
ContentAuth

Retrieve a specific content item by ID

POST/content/save
ContentAuth

Save or update a content item

POST/content/regenerate-section
ContentAuth

Regenerate a specific section of existing content

GET/templates
TemplatesAuth

List all available content templates

GET/templates/{slug}
TemplatesAuth

Retrieve a specific template by slug

GET/style-profiles
Style ProfilesAuth

List all available style profiles

GET/style-profiles/{slug}
Style ProfilesAuth

Retrieve a specific style profile by slug

GET/dashboard/stats
AnalyticsAuth

Retrieve usage statistics and generation counts

GET/health
SystemPublic

System health check endpoint

Error Codes

400Bad request — invalid fields
401Unauthorized — invalid API key
402Payment required — insufficient credits
403Forbidden — plan does not include this pipeline
429Rate limit exceeded — back off and retry
500Server error — contact support with request ID

Content Generation

Submit a Generation Request

Generation runs asynchronously. The POST returns a request_id immediately. Poll the status endpoint until status: completed.

Request

POST https://api.writerzroom.com/v1/generate
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "template_id": "blog_article_generator",
  "style_profile_id": "general_blog",
  "inputs": {
    "topic": "AI in enterprise content marketing",
    "audience": "Marketing directors at B2B SaaS",
    "objective": "Educate on practical AI adoption"
  },
  "vertical": "saas_tech",
  "generation_mode": "standard"
}

Response

{
  "request_id": "req_xyz789",
  "status": "pending",
  "created_at": "2026-03-10T20:00:00Z"
}

Poll Generation Status

Polling Request

GET https://api.writerzroom.com/v1/generate/status/req_xyz789
Authorization: Bearer YOUR_API_KEY

Completed

{
  "request_id": "req_xyz789",
  "status": "completed",
  "content": {
    "title": "AI in Enterprise Content",
    "body": "...",
    "metadata": {
      "word_count": 2547,
      "seo_score": 87,
      "readability_score": 72
    }
  },
  "agents_used": [
    "planner", "researcher",
    "writer", "editor",
    "formatter", "seo", "publisher"
  ],
  "generation_time_seconds": 94
}

Failed

{
  "request_id": "req_xyz789",
  "status": "failed",
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Need 4 credits, have 0",
    "details": "Purchase a credit pack
      to continue."
  }
}

Multi-Agent Pipeline

Each generation flows through specialized agents: Planner (content strategy), Researcher (Tavily-powered web search with source verification), Call Writer (research coordination), Writer (content generation with AI-tell suppression), Editor (readability enforcement, quality gates), Formatter, SEO, and Publisher. State managed via LangGraph.

Content Templates

Templates are YAML-driven with dynamic parameter extraction. Each template defines structure, agent behavior, output policy, and generation contract. Use GET /templates to fetch valid slugs programmatically.

Blog & Articles

  • Blog Article Generator
  • General Blog
  • Thought Leadership
  • Popular Science

Business & Strategy

  • Business Proposal
  • Executive Summary
  • Market Analysis
  • Strategic Brief

Technical

  • Technical Documentation
  • API Documentation
  • Deployment Guide
  • System Architecture

Academic & Research

  • Research Paper
  • PhD Dissertation
  • Literature Review
  • Methodology Paper

Marketing

  • Press Release
  • Email Newsletter
  • Product Launch
  • Brand Storytelling

Creative & Scripts

  • TV Premium Drama
  • Feature Screenplay
  • TV Comedy Writing
  • Cinematic Dialogue

Style Profiles

Style profiles define voice, tone, sentence complexity, and formatting behavior. Use GET /style-profiles to fetch valid slugs programmatically.

Professional

Enterprise and professional communication styles

Technical DiveExecutive SummaryPhD AcademicBoard Presentation

Marketing

Marketing and promotional content voices

Content MarketingThought LeadershipBrand StorytellingConversion Optimization

Academic

Research and academic writing styles

Scholarly CommentaryLiterature ReviewPeer Review ArticleConference Abstract

Creative

Narrative and creative writing voices

Cinematic DialogueTV Premium DramaFounder StorytellingSocial Media Voice

Plans & Generation Tiers

Demo

$9.99one-time

6 total

Quick + Standard (1 credit)

Quick = 1, Standard = 4

Starter

$39/mo

500/mo

Quick only

Quick = 1 cr

Professional

$99/mo

1,200/mo

Quick + Standard

Quick = 1, Standard = 4

Enterprise

$149/mo

2,000/mo

Quick + Standard + Premium

Quick = 1, Standard = 4, Premium = 5

Generation Tier Comparison

TierCreditsTimeModelsBest for
Quick115–30sFast (all agents)Drafts, internal docs, iteration
Standard460–120sFast + Standard quality (writer, editor)Published content, client deliverables
Premium590–180s + reviewFast + Maximum quality (writer, editor)High-stakes: white papers, research, investor decks

Rate Limits

10 requests per minute per account. Exceeding your credit balance returns HTTP 402. Requesting a pipeline your plan does not include returns HTTP 403. Monitor usage via /api/credits/usage. Purchase add-on packs (250, 500, or 1,000 credits) to extend your balance mid-cycle.

Support & Resources

System Status

Monitor real-time system health, circuit breaker status, and service availability.

View System Status

Support

Report issues or request features. Include your request ID for generation failures.

support@writerzroom.com

Enterprise Integration Support

Need custom integrations, dedicated support, or white-label solutions? Enterprise customers receive priority API access, dedicated account management, and custom SLA agreements.

View Enterprise Plans