Skip to main content
POST
/
sessions
/
new
Start a new session/turn
curl --request POST \
  --url https://api.raccoonai.tech/sessions/new \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task": "<string>",
  "mode": "auto",
  "files": [
    {
      "key": "<string>",
      "name": "<string>",
      "type": "<string>",
      "size": 123
    }
  ],
  "ace_version": "fast",
  "base_prompt": "<string>",
  "references": [
    {}
  ],
  "history": [
    {}
  ],
  "continuation": "<string>"
}
'
{
  "session_id": "<string>",
  "user_message_id": "<string>",
  "agent_message_id": "<string>"
}

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.