---
title: "Get User Voice Profile"
method: GET
path: "/api/agent/user-voice-profile"
tags: ["Business Intelligence"]
---

# Get User Voice Profile

`GET /api/agent/user-voice-profile`

Return the authenticated human's global personal voice profile.

## Query parameters

- `user_id` string, nullable
- `org_id` string, nullable

## Response `200`

Successful Response

- UserVoiceProfileStateResponse
  - `voice_profile` StoredVoiceProfile — Persisted minimal voice profile shape shown to users and loaded by writing flows.
    - `updated_at` string, required — ISO timestamp when the voice profile was last refreshed.
    - `audiences` EditableVoiceProfile, required — Audience-aware voice profile designed for agent use and direct user editing.
      - `client_facing` EditableVoiceProfileAudience, required — Slim, user-editable audience guidance stored on the org record.
        - `description` string — Short description of how the business should sound with this audience.
        - `tags` VoiceProfileTag[] — Optional preset tags the user wants the agent to lean on.
        - `examples` string[] — Optional synthetic examples that demonstrate the desired tone without quoting real messages.
      - `internal_casual` EditableVoiceProfileAudience, required — Slim, user-editable audience guidance stored on the org record.
        - `description` string — Short description of how the business should sound with this audience.
        - `tags` VoiceProfileTag[] — Optional preset tags the user wants the agent to lean on.
        - `examples` string[] — Optional synthetic examples that demonstrate the desired tone without quoting real messages.
      - `non_client_external` EditableVoiceProfileAudience, required — Slim, user-editable audience guidance stored on the org record.
        - `description` string — Short description of how the business should sound with this audience.
        - `tags` VoiceProfileTag[] — Optional preset tags the user wants the agent to lean on.
        - `examples` string[] — Optional synthetic examples that demonstrate the desired tone without quoting real messages.
  - `voice_profile_meta` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)