Style Profiles API

Discover available style profiles and retrieve the details needed for selection.

Use the Style Profiles API to list available writing modes and retrieve individual profile details before generation.

This keeps integrations aligned with the current WriterzRoom style profile catalog instead of relying on hard-coded options.

Style Profile Overview

Tone

Controls how the content sounds.

Voice

Shapes perspective, authority, and personality.

Audience

Aligns output with reader expectations.

Format

Supports platform and writing constraints.

List Style Profiles

GET https://api.writerzroom.com/v1/style-profiles
Authorization: Bearer YOUR_API_KEY

{
  "style_profiles": [
    {
      "id": "general_blog",
      "name": "General Blog",
      "category": "marketing",
      "tone": "conversational",
      "formality": "moderate"
    },
    {
      "id": "phd_academic",
      "name": "PhD Academic",
      "category": "academic",
      "tone": "formal",
      "formality": "high"
    }
  ]
}

Get Style Profile by Slug

GET https://api.writerzroom.com/v1/style-profiles/{slug}
Authorization: Bearer YOUR_API_KEY

Supported Operations

Operation	Description
List style profiles	Retrieve available writing modes
Get style profile	Retrieve one profile by slug
Read metadata	Access tone, voice, audience, platform, and formatting details

Integration Flow

1. Fetch available style profiles

   Call GET /style-profiles to retrieve the current catalog.

2. Display compatible options

   Use profile metadata to show users relevant writing modes.

3. Store the selected slug

   Save the selected style_profile_id for the generation request.

4. Submit generation

   Send the selected style profile with the template and structured input.

Best Practice

Use the API catalog as the source of truth for style profile selection. This keeps your integration current as WriterzRoom adds, updates, or refines style profiles.

Should style profiles be hardcoded?

Avoid hardcoding style profile lists in production integrations. Fetch the current catalog from the API when building selection interfaces.

What does a style profile control?

A style profile controls tone, voice, depth, pacing, formality, audience behavior, and platform-specific writing expectations.

How does this relate to templates?

Templates define what the system creates. Style profiles define how the content should sound and read.

Pair /style-profiles with /templates so users can select both structure and writing behavior before submitting a generation request.

Templates API

Retrieve available templates for generation setup.

Generate Content

Submit a request using the selected style profile.