Skip to main content

What is a Profile?

A profile is GetProfile’s representation of a user. It stores:
  • Identity: External ID (your app’s user identifier)
  • Traits: Structured attributes extracted from conversations
  • Summary: AI-generated natural language description
  • Metadata: Creation time, last update, summary version

Profile Structure

External ID vs Profile ID

It’s important to understand the difference between these two identifiers.
When making requests to the proxy, you always use your external ID via the X-GetProfile-Id header. GetProfile maps this to the internal profile ID automatically.

Profile Creation

Profiles are created automatically when a user makes their first request:

Profile Summary

The summary is a natural language description of the user, generated by analyzing their traits and memories:
Summaries are regenerated when:
  • High-priority traits change (name, language, expertise)
  • Enough time has passed since the last update (configurable)