> ## Documentation Index > Fetch the complete documentation index at: https://docs.hq.zone/llms.txt > Use this file to discover all available pages before exploring further. # List facts about me > Returns the facts the assistant currently remembers about the calling user, scoped to the caller's own account. Each fact includes its id, text, type, confidence, the agent that asserted it, when it was asserted, and the source conversation id. The response also includes a distilled one-paragraph persona summary (and when it was last generated, if available) and the distinct fact types present across the full set for use as filters. Supports filtering by agent slug and fact type, page sizing via limit (default 25, max 200), and forward pagination via an opaque cursor that returns null once the end is reached. ## OpenAPI ````yaml GET /v1/memory/about-me openapi: 3.1.0 info: title: HQ API description: >- Public HTTP API for HQ. Authenticate with a Personal Access Token (`Authorization: Bearer hq_pat_...`) for server-side integrations, or an OAuth 2.1 authorization-code + PKCE flow for browser apps acting on a user's behalf. Both grant from the same resource:action scope vocabulary; an endpoint's required scope is listed under its `security`. license: name: Apache-2.0 identifier: Apache-2.0 version: 1.0.0 servers: - url: https://api.hq.zone description: HQ API (production) security: [] tags: - name: me description: The signed-in user's own account - name: conversations description: Conversations and their messages - name: documents description: The content-addressed documents library - name: schedules description: Scheduled prompts and recurring tasks - name: agents description: Agents, their skills and integrations - name: memory description: What the assistant remembers (L5 governance) - name: tokens description: Personal Access Token management - name: billing description: Usage and billing - name: notifications description: In-app notification center - name: admin description: Workspace administration - name: integrations description: Workspace integrations (Slack, MCP, skills) - name: onboarding description: New-workspace onboarding wizard - name: auth description: Sign-in, sessions, and OAuth paths: /v1/memory/about-me: get: tags: - memory summary: List facts about me description: >- Returns the facts the assistant currently remembers about the calling user, scoped to the caller's own account. Each fact includes its id, text, type, confidence, the agent that asserted it, when it was asserted, and the source conversation id. The response also includes a distilled one-paragraph persona summary (and when it was last generated, if available) and the distinct fact types present across the full set for use as filters. Supports filtering by agent slug and fact type, page sizing via limit (default 25, max 200), and forward pagination via an opaque cursor that returns null once the end is reached. operationId: list_facts parameters: - name: agent in: query description: |- Restrict to one agent's view. Slug; omit for all agents in the workspace that have facts about the caller. required: false schema: type: - string - 'null' - name: fact_type in: query description: Restrict to one fact_type. Omit for all. required: false schema: type: - string - 'null' - name: limit in: query description: |- Default 25, max 200. Paginate via `cursor` rather than bumping this for "show more" - limit is meant to size each page. required: false schema: type: - integer - 'null' format: int64 - name: cursor in: query description: |- Opaque cursor returned by the previous page. URL-safe base64 of `{asserted_at, id}` - fed back as the WHERE bound so concurrent inserts don't shift the page boundary. required: false schema: type: - string - 'null' responses: '200': description: Facts the assistant remembers about you content: application/json: schema: $ref: '#/components/schemas/AboutMeResp' security: - bearer_pat: - memory:read - oauth2: - memory:read components: schemas: AboutMeResp: type: object required: - facts - fact_types_available properties: fact_types_available: type: array items: type: string description: |- Distinct fact_types present in the caller's full set (not the filtered page). Used by the UI to render filter chips - caller doesn't have to scan the whole set to know what's in there. facts: type: array items: $ref: '#/components/schemas/FactEntry' next_cursor: type: - string - 'null' description: |- Cursor to pass on the next page. `None` once the caller has reached the tail of the result set. persona_generated_at: type: - string - 'null' format: date-time description: |- When `persona_paragraph` was last refreshed. UI shows "updated X minutes ago" so the user can request a re-distill if the paragraph is stale relative to recent activity. persona_paragraph: type: - string - 'null' description: |- Per docs/agent-runtime.md §System prompt envelope, layer 4 (the user persona). Rendered once per (tenant, user, ~day) from the structured `user_profile.profile` JSONB by `hq-reflection-worker`. Surfaced FIRST in this response so the user reads + corrects the one-paragraph view in a single screen before diving into the per-fact list. `None` when the persona hasn't been distilled yet. FactEntry: type: object required: - id - fact - fact_type - confidence - agent_slug - asserted_at - source_conv_id properties: agent_slug: type: string asserted_at: type: string format: date-time confidence: type: number format: float fact: type: string fact_type: type: string id: type: string format: uuid source_conv_id: type: string format: uuid securitySchemes: bearer_pat: type: http scheme: bearer bearerFormat: hq_pat description: 'Personal Access Token. Send as `Authorization: Bearer hq_pat_...`.' oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hq.zone/v1/oauth/authorize tokenUrl: https://api.hq.zone/v1/oauth/token refreshUrl: https://api.hq.zone/v1/oauth/token scopes: admin: Administer the workspace (users, settings, integrations) agents:read: View the agents in your workspace agents:write: Create and configure agents billing:read: View usage and billing information conversations:read: Read your conversations and their messages conversations:write: Start conversations and send messages on your behalf documents:read: Read your documents library documents:write: Upload and manage documents in your library memory:read: Read what the assistant remembers about you memory:write: Correct or delete what the assistant remembers schedules:read: View your scheduled tasks schedules:write: Create and manage scheduled tasks tables:read: Read your tables and their rows tables:write: Create tables and add, edit, or delete rows ````