Get User Bio

Retrieve the user’s auto-generated biographical summary

Retrieves the user’s auto-generated biographical summary, which is created from their stored memories and provides a concise overview of their background, interests, and key characteristics.

cURL

curl -X GET 'https://api.memchat.io/profile/bio' \
  -H 'X-API-Key: YOUR_API_KEY'

Query Parameters

format · string · default: "full"

Bio format to retrieve. Options: full, short, bullets, professional

refresh · boolean · default: "false"

Whether to regenerate the bio from latest memories

style · string · default: "narrative"

Writing style for the bio. Options: narrative, factual, casual, formal

exclude_categories · string

Comma-separated list of categories to exclude from bio generation

Response

bio · string

The auto-generated biographical text

format · string

Format of the returned bio

style · string

Writing style used for the bio

word_count · number

Number of words in the bio

character_count · number

Number of characters in the bio

confidence · number

Confidence score for bio accuracy (0.0-1.0)

source_memories · number

Number of memories used to generate the bio

categories_included · array

List of memory categories included in bio generation

key_themes · array

Main themes identified in the bio

generated_at · string

ISO 8601 timestamp when bio was generated

expires_at · string

ISO 8601 timestamp when bio will be considered stale

Full Bio Response

{
  "bio": "A passionate software engineer and AI enthusiast currently based in San Francisco, working at a cutting-edge tech startup that focuses on machine learning applications in healthcare. With a strong background in Python development and a deep interest in how technology can improve medical outcomes, they regularly collaborate with healthcare professionals to develop innovative solutions.\n\nOutside of work, they maintain an active lifestyle through hiking in the Bay Area's beautiful trails and stay intellectually curious through extensive reading about emerging technologies. Family time is important to them, and they often balance their technical pursuits with meaningful personal relationships.\n\nTheir commitment to sustainability influences both their personal choices and professional interests, leading them to explore green technology solutions. Frequent travel for both professional conferences and leisure has broadened their perspective and contributed to their well-rounded approach to life and work.\n\nThey embody a philosophy of continuous learning, always seeking to expand their knowledge in artificial intelligence, healthcare technology, and sustainable innovation while maintaining strong connections with colleagues like Sarah Johnson and Dr. Martinez in their professional network.",
  "format": "full",
  "style": "narrative",
  "word_count": 164,
  "character_count": 1021,
  "confidence": 0.92,
  "source_memories": 89,
  "categories_included": [
    "career",
    "interests", 
    "relationships",
    "learning",
    "travel"
  ],
  "key_themes": [
    "Technology and AI",
    "Healthcare Innovation",
    "Continuous Learning",
    "Work-Life Balance",
    "Sustainability"
  ],
  "generated_at": "2024-01-15T16:30:00Z",
  "expires_at": "2024-01-22T16:30:00Z"
}

Bio Formats

Full Bio

A comprehensive 150-200 word narrative bio covering all major aspects of the user’s life and interests based on their memories.

Short Bio

A concise 30-50 word summary highlighting the most important aspects of the user’s profile.

Bullets Bio

A structured list of key points about the user, organized as bullet points for easy scanning.

Professional Bio

A professional-focused bio emphasizing career, skills, and professional achievements while minimizing personal details.

Writing Styles

Narrative

Flowing, story-like prose that reads naturally and engagingly.

Factual

Straightforward, fact-based presentation without narrative flourishes.

Casual

Informal, conversational tone that feels personal and approachable.

Formal

Professional, polished tone suitable for business contexts.

Error Responses

401 · object

Unauthorized access

{
  "error": "Invalid or expired token",
  "code": "UNAUTHORIZED"
}

404 · object

Bio not yet generated

{
  "error": "Bio not yet generated",
  "code": "BIO_NOT_FOUND",
  "suggestion": "Store at least 5 memories to generate a bio",
  "current_memory_count": 3
}

400 · object

Invalid format or style

{
  "error": "Invalid bio format specified",
  "code": "INVALID_FORMAT",
  "valid_formats": ["full", "short", "bullets", "professional"]
}

429 · object

Rate limit exceeded

{
  "error": "Too many bio generation requests",
  "code": "RATE_LIMIT_EXCEEDED",
  "retry_after": 60
}

Generation Requirements

Bio generation requires:

• Minimum memories: At least 5 stored memories
• Category diversity: Memories from at least 2 different categories
• Content quality: Memories with sufficient text content (>10 words each)

Refresh Behavior

• Automatic refresh: Bios are refreshed when significant new memories are added
• Manual refresh: Use refresh=true to force regeneration
• Cooldown period: Refreshes are limited to once every 10 minutes
• Expiration: Bios are considered stale after 7 days and will auto-refresh on next request

Privacy Considerations

• Bio generation respects memory privacy settings
• Private category memories are excluded unless specifically enabled
• Bio visibility can be controlled through profile privacy settings
• Generated bios never include sensitive metadata like exact locations or private details