Chat with Modus
Starts a new conversation with Modus — your org-wide assistant with access to all context and tools. Returns threadId for follow-up via POST …/conversations//chat. Requires model.
Requires: scopes:invoke
Authorizations
A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.
Body
Canonical model id for this run (required). Allowed values: claude-sonnet-5, claude-sonnet-4.6, claude-opus-4.8, gpt-5.2, gpt-5.5, gpt-5-mini, gpt-oss-120b, gpt-oss-20b, qwen3-235b-a22b-2507, qwen3-coder, qwen3-32b, deepseek-chat-v3.1, minimax-m2.7, llama-4-maverick, llama-4-scout, llama-3.3-70b-instruct, gemini-3.1-pro-preview, gemini-3-flash-preview, grok-4.3-fast, grok-4.3.
claude-sonnet-5, claude-sonnet-4.6, claude-opus-4.8, gpt-5.2, gpt-5.5, gpt-5-mini, gpt-oss-120b, gpt-oss-20b, qwen3-235b-a22b-2507, qwen3-coder, qwen3-32b, deepseek-chat-v3.1, minimax-m2.7, llama-4-maverick, llama-4-scout, llama-3.3-70b-instruct, gemini-3.1-pro-preview, gemini-3-flash-preview, grok-4.3-fast, grok-4.3 "claude-sonnet-4.6"
User message sent to Modus. Omit when approvalContinuation is true.
1"What were our top revenue drivers last quarter?"
Continue a pending write-approval interrupt from a prior turn. When true, message is ignored.
Required when approvalContinuation is true.
approve, deny Response
Final assistant text for the run.
"Revenue grew 12% quarter over quarter…"
Conversation thread id. For follow-up use POST …/conversations/{threadId}/chat.
"agent_0_550e8400-e29b-41d4-a716-446655440000"
Opaque run id for this chat invocation.
"550e8400-e29b-41d4-a716-446655440001"