Skip to main content
POST
/
api
/
v1
/
agents
/
{id}
/
conversations
/
{threadId}
/
chat
Chat with a published agent (buffered, continue thread)
curl --request POST \
  --url https://api.staging.getmodus.com/api/v1/agents/{id}/conversations/{threadId}/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "Summarize open support tickets from last week.",
  "model": "claude-sonnet-4.6"
}
'
{
  "content": "There were 12 open tickets last week…",
  "threadId": "api-skill-42-550e8400-e29b-41d4-a716-446655440000",
  "runId": "550e8400-e29b-41d4-a716-446655440001"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
number
required

Numeric agent id.

Example:

7

​
threadId
string
required

Thread id from a prior task-agent chat response.

Example:

"api-auto-7-550e8400-e29b-41d4-a716-446655440000"

Body

application/json
​
message
string
required

User message sent to the published skill 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-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-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"