POST
/
sessions
{
  "situation": "<string>",
  "system_template": "<string>",
  "summary": "<string>",
  "render_templates": true,
  "token_budget": 123,
  "context_overflow": "truncate",
  "auto_run_tools": false,
  "forward_tool_calls": false,
  "recall_options": {
    "limit": 10,
    "lang": "en-US",
    "metadata_filter": {},
    "num_search_messages": 4,
    "max_query_length": 1000,
    "mode": "vector",
    "confidence": 0.5,
    "mmr_strength": 0.5
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "kind": "<string>"
}

Authorizations

​
Authorization
string
header
required

Body

application/json

Payload for creating a session

​
user
string | null
​
users
string[] | null
​
agent
string | null
​
agents
string[] | null
​
situation
string | null
​
system_template
string | null
​
render_templates
boolean
default:true
​
token_budget
integer | null
​
context_overflow
enum<string> | null
Available options:
truncate,
adaptive
​
auto_run_tools
boolean
default:false
​
forward_tool_calls
boolean
default:false
​
recall_options
object | null
​
metadata
object | null

Response

201
application/json
Successful Response
​
id
string
required
​
created_at
string
required
​
updated_at
string
required
​
situation
string | null
​
system_template
string | null
​
summary
string | null
​
render_templates
boolean
default:true
​
token_budget
integer | null
​
context_overflow
enum<string> | null
Available options:
truncate,
adaptive
​
auto_run_tools
boolean
default:false
​
forward_tool_calls
boolean
default:false
​
recall_options
object | null
​
metadata
object | null
​
kind
string | null