humantic_pi_profile_refresh_v1

Re-run a stale profile against current data.

At a glance

Key inputs

One of profile_id / linkedin_url / email; optional force.

Upstream API

POST /v1/user-profile/create (profile_refresh=true)

Example ask

Sarah Chen moved to a new company — refresh her Humantic AI profile.

Example tool call

humantic_pi_profile_refresh_v1({
  "linkedin_url": "https://linkedin.com/in/sarah-chen-vp",
  "force": true
})

Example output

{
  "status": "200",
  "message": "Success",
  "results": {
    "display_name": "Sarah Chen",
    "user_description": "Chief Operating Officer at Globex"
  },
  "metadata": { "confidence": { "score": 94, "level": "High Confidence" }, "analysis_status": "COMPLETE" },
  "_status": "ready",
  "_idempotency_hit": false,
  "_trace_id": "3b91f0c7ad24e185",
  "_quota": { "pool": "api", "limit": 3000, "consumed": 414, "remaining": 2586 }
}

Good to know. Consumes a profile credit — this re-pulls the source data and re-runs the analysis, unlike profile_fetch which serves the stored copy. Use it when the person has changed roles or companies. Identical args within 24h are deduped and cost nothing (_idempotency_hit: true); pass force: true to actually re-run. To add NEW information instead of re-pulling existing sources, use profile_update.