Endpoints Reference

Complete reference for WriterzRoom API endpoints.

The WriterzRoom API exposes generation, status tracking, content management, templates, style profiles, verticals, and dashboard usage endpoints through one versioned base URL.

https://api.writerzroom.com/v1

All protected endpoints require Bearer token authentication.

Authorization: Bearer YOUR_API_KEY

Endpoint Overview

Generation

Submit jobs and poll completion status.

Content

Retrieve, save, and manage generated drafts.

Configuration

Fetch templates, styles, and vertical settings.

Usage

Review account statistics and activity.

Base URL

https://api.writerzroom.com/v1

Core Endpoints

Method	Endpoint	Description
POST	/generate	Submit a generation request
GET	/generate/status/{request_id}	Poll generation status and retrieve completed content
GET	/content	List saved content for the authenticated user
GET	/content/{contentID}	Retrieve a specific content item
POST	/content/save	Save or update a content item
POST	/content/regenerate-section	Regenerate a specific section of existing content
GET	/templates	List available templates
GET	/templates/{slug}	Retrieve a specific template by slug
GET	/style-profiles	List available style profiles
GET	/style-profiles/{slug}	Retrieve a specific style profile by slug
GET	/verticals	List available verticals
GET	/verticals/{vertical_id}	Retrieve vertical configuration details
GET	/dashboard/stats	Retrieve usage statistics and generation counts

Request Example

curl -X GET https://api.writerzroom.com/v1/templates \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Response Example

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key"
  }
}

Integration Flow

1. Authenticate requests

   Add the Authorization: Bearer YOUR_API_KEY header to every protected request.

2. Fetch valid configuration

   Use /templates, /style-profiles, and /verticals to retrieve valid identifiers before submitting generation jobs.

3. Submit generation

   Call POST /generate with the selected template, style profile, vertical, generation mode, and structured input.

4. Poll for completion

   Use /generate/status/{request_id} to retrieve processing updates and completed content.

5. Save or manage content

   Use content endpoints to retrieve, save, update, or regenerate content sections.

Rate Limits

Limit	Value
Per-account request rate	10 requests per minute
Rate limit response	429
Recommended retry strategy	Exponential backoff
Generation accounting	Monthly plan usage

Error Codes

Status	Meaning
400	Bad request, missing fields, or invalid payload
401	Unauthorized, missing or invalid API key
403	Forbidden, plan does not include API access
404	Resource not found
429	Rate limit exceeded
500	Internal server error

Exponential Backoff Example

async function requestWithBackoff(fn, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      const isRateLimited = error.status === 429;

      if (!isRateLimited || attempt === maxRetries - 1) {
        throw error;
      }

      const delayMs = Math.pow(2, attempt) * 1000;
      await new Promise((resolve) => setTimeout(resolve, delayMs));
    }
  }
}

Operational Guidance

Which base URL should integrations use?

Use https://api.writerzroom.com/v1 for public API integrations.

Should identifiers be hardcoded?

Avoid hardcoding identifiers for large integrations. Fetch templates, style profiles, and verticals programmatically when possible.

How should rate limits be handled?

Treat 429 as a retryable response and apply exponential backoff. Do not retry immediately in tight loops.

What information should be included in support requests?

Include the endpoint, timestamp, request ID if available, response status, and sanitized error body.

Do not send API keys in query parameters. Always use the Authorization header.

API Authentication

Learn how to authenticate API requests.

Check Generation Status

Poll submitted generation jobs until completion.