Skip to main content
POST
Send Agent Message

Authorizations

Authorization
string
header
required

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

Body

application/json
sessionId
string<uuid>

Omit to start a new session; pass an existing id to continue it

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
prompt
string
default:""
Maximum string length: 100000
attachments
object[]

Transfer reference files that are not otherwise accessible to the Agent here. Usable URLs in the prompt, existing Krea context, and prior session files need not be repeated in attachments. The Agent does not inherit your conversation or attachments. Mentioning OpenAI file_ IDs in prompt text does not transfer their bytes, and those IDs cannot be converted to Krea file URIs.

Maximum array length: 20
model
enum<string>

Pin an LLM. Omit for Auto. Must be included in the workspace plan.

Available options:
openai/gpt-6-astra,
openai/gpt-6.1-sol,
openai/gpt-6-sol,
openai/gpt-6-luna,
openai/gpt-5.6-sol,
openai/gpt-5.6-terra,
openai/gpt-5.6-luna,
openai/gpt-5.5,
anthropic/claude-opus-5.5,
anthropic/claude-opus-5,
anthropic/claude-fable-5.1,
anthropic/claude-fable-5,
anthropic/claude-opus-4.8,
anthropic/claude-sonnet-5,
anthropic/claude-sonnet-4.5,
anthropic/claude-opus-4.5,
google/gemini-4-argon,
google/gemini-3.8-flash,
google/gemini-3.5-flash,
google/gemini-3.5-flash-lite,
google/gemini-3.1-pro-preview,
google/gemini-3.1-flash-lite,
google/gemini-2.5-flash-lite,
xai/grok-4.5,
zai/glm-5.2,
moonshotai/kimi-k3
effort
enum<string>
Available options:
fast,
default,
high,
xhigh
name
string

Session name, new sessions only

Required string length: 1 - 120
desktopAppId
string<uuid>

An appId from list_desktop_apps. The Agent then works inside that desktop app for this turn.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

The Agent session result.

sessionId
string
required
threadId
string
required
runId
string
required
status
enum<string>
required
Available options:
running
url
string
required