search

rulerDistill

Distill allows you to leverage your user's identifiers & traits to refine users into helpful summaries & insights. Raw data is transformed into intelligence for improved analytics and decision making.

hashtag
Distill user

GET /distill/:userId

Distill a known user

Generating a distillation can take a few seconds. Attuitive will cache a user's distillation summary, significantly reducing the duration of subsequent requests. Only if the information of a user has changed will a new distillation be generated. You can override this behaviour with the refresh query parameter if required.

TIP: Requesting cached distillations will not be counted as an intelligence event.

Headers

Name
Value

Content-Type*

application/json

Authorization*

Bearer <token>

Query

Name
Type
Description

:userId*

string

ID of the user. usr_[A-Za-z0-9]{16}

refresh

string

Whether a new distillation should be generated, regardless of if a current one exists. true or false.

Response

{
  "new": true // Whether this is a newly generated distillation
  "id": "usr_dst_XXX",
  "workspaceId": "ws_XXX",
  "user_id": "usr_XXX",
  "summary": "Jane is a 34-year-old customer based in San Francisco, CA. She has spent over $1,200 with the brand and typically places medium-sized orders. Jane is..."
}

Important: Fields with a * must be included in your request!

PreviousTrack

Last updated