Projects

Projects help you organize memories into logical groups. Think of them as namespaces or containers for related memories.

Why Use Projects?

Separation - Keep different applications’ memories separate
Organization - Group memories by user, client, or use case
Filtering - Search within a specific project
Permissions - Future: share specific projects with team members

Default Project

Every user has a default project that’s used when no project is specified:

{
  "id": "proj_default",
  "name": "default",
  "description": "Default project"
}

Creating Projects

Create projects via API:

curl -X POST https://t0ken.ai/api/v1/projects \
  -H "X-API-Key: omx_your_api_key" \
  -d '{
    "name": "customer-support-bot",
    "description": "Memories for the support chatbot"
  }'

Project Naming

Use lowercase letters, numbers, and hyphens
Keep names descriptive but concise
Use consistent naming conventions

Good examples:

myapp-production
customer-support
user-12345

Using Projects

Specify the project when creating memories:

curl -X POST https://t0ken.ai/api/v1/memories \
  -H "X-API-Key: omx_your_api_key" \
  -d '{
    "content": "User asked about pricing",
    "project_id": "customer-support-bot"
  }'

Filter by project when searching:

curl -X POST https://t0ken.ai/api/v1/memories/search \
  -H "X-API-Key: omx_your_api_key" \
  -d '{
    "query": "pricing questions",
    "project_id": "customer-support-bot"
  }'

Getting Started

Core Concepts

Integrations

Why Use Projects?

Default Project

Creating Projects

Project Naming

Using Projects

​Why Use Projects?

​Default Project

​Creating Projects

​Project Naming

​Using Projects

Why Use Projects?

Default Project

Creating Projects

Project Naming

Using Projects