Skip to main content
POST
Auto Derive And Save Person Voice

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

force
boolean
default:false

Re-derive and overwrite even a manually-edited voice. Default false no-clobbers a user-edited voice (returns it untouched).

Response

Successful Response

Result of the auto-derive-and-save (POST). voice is the persisted row (or, on a no-clobber skip, the EXISTING user-edited row). skipped_user_edited is true when a normal call left a manually-edited voice untouched. The per-arm status echoes the RICH X status (derived / no_connection / needs_reauth / empty_timeline / unavailable)

  • the collapsed LinkedIn status (ok / absent / error) so the FE keeps the nuance even though the persisted column stores the mapped CHECK value.
voice
PersonVoiceResponse · object
required

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.

linkedin_arm_status
string
required
x_arm_status
string
required
skipped_user_edited
boolean
default:false
linkedin_arm_detail
string
default:""
x_arm_detail
string
default:""