MaveraMavera Docs
Reference
Checking…
Use or share this pageSend the page itself, print it, or open its complete context in your AI workspace.

Projects & folders

Workspace organization.

1 min readDocs build Updated Jul 26, 2026

Projects

EndpointDoes
POST /api/v1/tools/create_projectCreate a project. Body: { name, description? }.
POST /api/v1/tools/list_projectsList projects. { includeArchived? }.
POST /api/v1/tools/update_projectRename / re-describe / archive. { projectId, name?, description?, status? }.

Conversations

file_conversationMove a chat into a project — or projectId:null to unfile. { conversationId, projectId }.
update_conversationRename, tag, or archive. { conversationId, title?, tags?, archived? }.
list_conversationsFilter by project, unfiledOnly, text query, includeArchived.
# File a chat into a project, then tag it
POST /api/v1/tools/create_project       { "name": "Q3 Pricing" }    # → { project: { id: "proj_…" } }
POST /api/v1/tools/file_conversation    { "conversationId": "chat_abc", "projectId": "proj_…" }
POST /api/v1/tools/update_conversation  { "conversationId": "chat_abc", "tags": ["pricing","smb"] }

Everything here is workspace-scoped: a key can only see and organize its own workspace's projects and conversations. Filing into a project from another workspace is rejected.

On this page