> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Profiles

> Turn accumulated memory into a ready-to-use understanding of a user

| Operation | Purpose |
| - | - |
| `POST /ns/{namespace}/profile` | Retrieve durable facts, recent context, and custom insights |
| `GET /ns/{namespace}/profile/buckets` | See the profile categories available here |
| `PUT /ns/{namespace}/profile/buckets` | Shape the profile with namespace-specific categories |
| `DELETE /ns/{namespace}/profile/buckets` | Remove namespace-specific categories |

<CodeGroup>
  ```ts TypeScript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  const { profile } = await supermemory.profile("user_1")

  await supermemory.profiles.setBuckets("user_1", {
    buckets: { work: "Professional preferences and ongoing work" },
  })
  ```

  ```bash curl theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  curl -X POST "https://api.supermemory.ai/ns/user_1/profile" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{}'

  curl -X PUT "https://api.supermemory.ai/ns/user_1/profile/buckets" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"buckets":{"work":"Professional preferences and ongoing work"}}'
  ```
</CodeGroup>

Profiles always contain static and dynamic sections, giving applications both durable knowledge and fresh context without composing them manually. Organization-owned buckets may be inherited but cannot be changed through namespace bucket endpoints.

See [profile migration](/docs/migration/api-v5-recall).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.