Chat with a published agent (buffered, new thread)

curl --request POST \ --url https://api.staging.getmodus.com/api/v1/agents/{id}/chat \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "message": "Summarize last week revenue.", "model": "claude-sonnet-4.6" } '

Authorizations

Authorization

string

header

required

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

Path Parameters

number

required

Numeric agent (automation) id.

Example:

7

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"