> ## Documentation Index > Fetch the complete documentation index at: https://bavlio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Save Person Voice Edits > Persist a USER-EDITED person voice and stamp ``manually_edited_at`` so future auto-derives no-clobber it. Only the editable voice fields (``PersonVoiceUpdateRequest``: tone/style/topics/do/ dont/sample_snippets) are accepted; the client can NOT write arm-status / provenance / internal columns (undeclared on the request model AND not in the service voice allowlist). ``manually_edited_at`` is stamped server-side via the trusted provenance channel. Scoped to the authenticated actor (``org_context.user_id``). ## OpenAPI ````yaml https://api.bavlio.com/openapi.json put /api/v1/content/person-voice openapi: 3.1.0 info: title: Bavlio API description: >- Outreach automation API — lead enrichment, email campaigns, LinkedIn automation, and AI agent. Full docs at https://docs.bavlio.com. version: 1.0.0 x-guidance: product: Bavlio Data API protocols: - x402 description: >- Pay-per-call B2B data endpoints for AI agents. USDC on Base mainnet via x402 v2. See /openapi.json for pricing. Landing page + marketing details: https://bavlio.com/developers network: eip155:8453 docs_url: https://docs.bavlio.com x-payment-merchant-address: '0xcca4725e0e931982830bff523b141e1a7a58d3e7' servers: [] security: [] tags: - name: API Keys description: >- Create, list, and revoke API keys for programmatic access. JWT authentication required. - name: credits description: Credit balance, cost estimates, and transaction history. - name: campaigns description: Create, manage, launch, and monitor email campaigns. - name: campaign-personalization description: AI-powered email subject and body personalization for campaigns. - name: email-finder description: Find and verify email addresses for prospects. - name: sender-profiles description: Manage sender identity profiles for outreach. - name: sender-profile-chat description: Interactive chat for building sender profiles. - name: templates description: Email template CRUD. - name: suppression description: Do-not-contact suppression list management. - name: datasets description: Lead dataset listing, download, and updates. - name: user-extractions description: Uploaded lead file management and processing. - name: enrichment-chat description: Interactive chat for data enrichment sessions. - name: enrichment-processing description: Batch lead enrichment processing. - name: File Upload (CSV/Excel) description: Upload and preview CSV/Excel lead files. - name: connected-accounts description: LinkedIn account connections via Unipile. - name: linkedin-content description: LinkedIn post creation, scheduling, and management. - name: linkedin-playground description: Direct LinkedIn actions (profile lookup, messaging, engagement). - name: bavimail-proxy description: BaviMail domain, alias, and email management. - name: agent description: Bavi AI agent chat with SSE streaming. - name: notifications description: Notification preferences and delivery. - name: referral description: Referral code management and stats. - name: feedback description: User feedback submission. - name: authentication description: JWT token verification and user info. - name: users description: User quota and usage information. - name: Health description: Health checks and system status. - name: Personalization description: Core lead personalization engine. - name: Session Management description: Enrichment session lifecycle. - name: Session Processing description: Session data processing. - name: webhooks description: Inbound webhook handlers (Stripe, BaviMail, Unipile). paths: /api/v1/content/person-voice: put: tags: - content summary: Save Person Voice Edits description: >- Persist a USER-EDITED person voice and stamp ``manually_edited_at`` so future auto-derives no-clobber it. Only the editable voice fields (``PersonVoiceUpdateRequest``: tone/style/topics/do/ dont/sample_snippets) are accepted; the client can NOT write arm-status / provenance / internal columns (undeclared on the request model AND not in the service voice allowlist). ``manually_edited_at`` is stamped server-side via the trusted provenance channel. Scoped to the authenticated actor (``org_context.user_id``). operationId: save_person_voice_edits_api_v1_content_person_voice_put requestBody: content: application/json: schema: $ref: '#/components/schemas/PersonVoiceUpdateRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PersonVoiceResponse' '401': description: Unauthorized '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: PersonVoiceUpdateRequest: properties: tone: type: string maxLength: 2000 title: Tone default: '' style: type: string maxLength: 2000 title: Style default: '' topics: items: type: string maxLength: 500 type: array maxItems: 25 title: Topics do_guidelines: items: type: string maxLength: 500 type: array maxItems: 25 title: Do Guidelines dont_guidelines: items: type: string maxLength: 500 type: array maxItems: 25 title: Dont Guidelines sample_snippets: items: type: string maxLength: 1000 type: array maxItems: 25 title: Sample Snippets type: object title: PersonVoiceUpdateRequest description: >- Save-edits payload (PUT). ONLY the editable voice fields are declared, so a client can never write arm-status / provenance / internal columns (an undeclared field is silently dropped — critical pattern #58 — and the service additionally allowlists). No ``positioning`` (company layer). The route stamps ``manually_edited_at`` server-side so future auto-derives no-clobber the user's edits. PersonVoiceResponse: properties: tone: type: string title: Tone default: '' style: type: string title: Style default: '' topics: items: type: string type: array title: Topics do_guidelines: items: type: string type: array title: Do Guidelines dont_guidelines: items: type: string type: array title: Dont Guidelines sample_snippets: items: type: string type: array title: Sample Snippets linkedin_arm_status: anyOf: - type: string - type: 'null' title: Linkedin Arm Status linkedin_arm_detail: anyOf: - type: string - type: 'null' title: Linkedin Arm Detail x_arm_status: anyOf: - type: string - type: 'null' title: X Arm Status x_arm_detail: anyOf: - type: string - type: 'null' title: X Arm Detail derived_at: anyOf: - type: string format: date-time - type: 'null' title: Derived At manually_edited_at: anyOf: - type: string format: date-time - type: 'null' title: Manually Edited At derivation_version: anyOf: - type: integer - type: 'null' title: Derivation Version updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At type: object title: PersonVoiceResponse description: >- The persisted PERSON voice (+ per-arm status + provenance). ``updated_at`` null means no row yet -- the FE auto-derive-and-saves on first load. The arm-status columns are the migration-249 CHECK vocabulary ('ok'/'absent'/'error') and may be null until a derive has run; the ``*_arm_detail`` carry the original rich reason. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.