Agent

Send Agent Message

Changed on

Start a Krea Agent session or send a follow-up turn by passing sessionId. Returns immediately while the Agent works in the background. Sessions are visible at the returned url and billed to the workspace's compute unit balance. The Agent does not ask questions, and cost and permission prompts are approved automatically: include all requirements in the prompt. A session runs one turn at a time. Attachments accept http(s) URLs and authorized Krea Files URIs (file:<uuid>). Model pins must be included in the workspace plan.

post/agent/send-message

Request

  • Base URL: https://api.krea.ai
  • URL: https://api.krea.ai/agent/send-message
  • Auth: HTTP bearer

Request body

sessionIdstring uuid

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

promptstring
model'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'

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

effort'fast' | 'default' | 'high' | 'xhigh'
namestring

Session name, new sessions only

desktopAppIdstring uuid

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

Response

The Agent session result.

sessionIdstring required
threadIdstring required
runIdstring required
status'running' required
urlstring required

Changes