Headless Integration

┌─────────────────┐      POST /v1/audit       ┌────────────────────┐
│ Partner App     │ ────────────────────────> │ Voice DNA™ Engine  │
│ (HubSpot/CRM)   │ <──────────────────────── │ (Vertex AI Backed) │
└─────────────────┘      voice_dna_id         └────────────────────┘

The Voice DNA™ API allows enterprise SaaS platforms, CRMs, social media dashboards, and communication apps to run our Voice Archetype Process directly inside their software ecosystems. By bypassing the consumer graphical user interface, developers can access our style injection pipelines through a standard REST API.

🔐 Operational Authentication & Constraints

Authentication Mechanism: Standard OAuth 2.0 via secure Bearer Tokens.

Global Context Window: Up to 65,535 tokens returned per operational query.

System Processing Timeout: All endpoint connections feature a strict 10-minute timeout to allow thorough linguistic evaluation.

Data Security Standard: Backed completely by Google Vertex AI , ensuring all target corporate records stay securely isolated within a fully compliant cloud infrastructure.

🛠️ Core API Endpoints

1. Ingest & Analyze Styles

HTTP
POST /v1/audit

Performs a deep technical style evaluation, checking incoming samples against 72 distinct language attributes to generate a secure profile ID.

  • Sample Payload Request:

JSON
{
  "sample_type": "text",
  "content": "Raw narrative sample text from target executive or historical communications repository...",
  "file_format": ".txt",
  "user_id": "enterprise_user_987abc"
}

  • Sample Payload Response:

JSON
{
  "voice_dna_id": "v_identity_789xyz",
  "audit_summary": {
    "tone": "Authoritative, precise, low hedging",
    "complexity_score": 9.4,
    "dominant_metaphors": ["architecture", "systems"],
    "analysis_points": 72
  },
  "status": "profile_created"
}

2. Execute Style Injection

HTTP
POST /v1/rewrite

Applies your stored Voice DNA rules to update generic drafts or outlines.

  • Sample Payload Request:

JSON
{
  "voice_dna_id": "v_identity_789xyz",
  "input_content": "Hey team, write an email explaining that our cloud systems are upgrading next week.",
  "context_type": "corporate_announcement"
}

  • Sample Payload Response:

JSON
{
  "original_content_length": 86,
  "transformed_content": "Team, we are upgrading our core cloud architecture next Tuesday to enhance enterprise stability and eliminate operational latency...",
  "transformation_metadata": {
    "rules_applied": 24,
    "voice_match_score": 0.99
  }
}

3. Granular Fine-Tuning

HTTP
POST /v1/refine

Allows real-time updates to context and presentation format without running a new profile audit.

  • Sample Payload Request:

JSON
{
  "previous_output_id": "tx_generation_abc123",
  "parameters": {
    "formality_level": 4,
    "reading_level": 11,
    "custom_instructions": "Make the summary highly technical and clear."
  }
}

  • Sample Payload Response:

JSON
 
{
  "final_content": "The cloud migration framework will deploy recursively to minimize session resets across consumer UI terminals...",
  "readability_score": "Flesch-Kincaid 11.1"
}