v4
latestOpenAPI 3.1.02026-08-03427198448.4 KBThread Management
Create Thread
Creates a new thread row.
WHO ACTUALLY CALLS THIS:
- mcp_server/admin/handlers/assistant.py (the admin MCP server at mcp.every.ai). External AI integrations like Claude.ai and ChatGPT invoke the ask_assistant MCP tool, which POSTs here to seed a thread before streaming agent output.
WHO DOES NOT:
- The web app (every-react) creates threads via a direct Supabase insert in packages/agent-chat/contexts/ThreadContext.tsx — RLS-protected.
- The mobile app (every-mobile-app) does the same in src/stores/threadStore.ts.
storage_mode is always "session"; the threads table column has the same NOT NULL default, so direct Supabase inserts land on the same value.
Idempotency: protected by idempotency_guard so MCP retries don't create duplicate threads. The MCP server doesn't send X-Idempotency-Key today but the guard is in place for future retry logic.
post/api/create-thread
Query parameters
user_idstring
org_idstring
Request body
Response
Successful Response
{"stackTrail":"paths:/api/create-thread:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}