Skip to main content
POST
Start a new session/turn

Authorizations

Authorization
string
header
required

API key from Raccoon AI

Body

application/json
session_id
string<uuid>
required

Session ID. Use the same ID to continue an existing session, or generate a new UUID for a fresh session.

task
string
required

Natural language description of what you want the agent to do

mode
enum<string>
required

Execution mode:

  • auto: General-purpose mode for any task
  • plan: Creates a detailed plan before execution
  • deepsearch: Optimized for web research and data analysis
  • slides: Generates presentation slides
  • code: Optimized for coding tasks
Available options:
auto,
plan,
deepsearch,
slides,
code
files
object[]

Files from the upload endpoint

ace_version
enum<string>

SDK version (optional)

Available options:
fast,
think
base_prompt
string

Base prompt or system instructions (optional)

references
object[]

Reference objects for additional context (optional)

history
object[]

Conversation history for continuation (optional)

continuation
string

Continuation data as JSON string (optional)

Response

Turn created successfully

session_id
string

Session ID (same as the session_id you provided). Use for WebSocket connection.

user_message_id
string

ID of the user's message

agent_message_id
string

ID of the agent's response message. Use as message_id for WebSocket connection.