Skip to main content
POST
Chat with a scope

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

Body

application/json
message
string
required

User message sent to the published scope supervisor.

Minimum string length: 1
Example:

"Summarize open support tickets from last week."

model
enum<string>
required

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.

Available options:
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
Example:

"claude-sonnet-4.6"

Response

content
string
required

Final assistant text for the run.

Example:

"There were 12 open tickets last week…"

threadId
string
required

Conversation thread id. For follow-up messages use POST …/conversations/{threadId}/chat (same id as GET …/conversations/{threadId}).

Example:

"api-skill-42-550e8400-e29b-41d4-a716-446655440000"

runId
string
required

Opaque run id for this chat invocation (for logging and correlation).

Example:

"550e8400-e29b-41d4-a716-446655440001"