Skip to main content
POST
Auto-derive contact trait tags via LLM

Body

application/json
contact_id
string
required

Contact identifier. The handler reads the contact's 30-day event mix + deterministic signals from the tenant schema before invoking the LLM.

Required string length: 1 - 200
Example:

"contact_01J8Z9K3P4Q5R6S7T8U9V0W1X2"

max_tags
integer
default:6

Soft cap on the tags the LLM proposes. Server-side clamping prevents a chatty model from blowing the contact-detail panel layout.

Required range: 1 <= x <= 10
Example:

6

Response

data.contact_id, the derived_traits tag/rationale array, derived_trait_tags_computed_at (null when persistence failed), the 30-day features summary the LLM read, and a truncated llm_output_preview — in the standard { data, meta } envelope.

data
object
required
meta
object
required