sessions

Create Or Update Session

post/sessions/{session_id}

Path parameters

session_idstring uuid required

Request body

userstring uuid nullable

usersstring[] nullable

agentstring uuid nullable

agentsstring[] nullable

situationstring nullable

system_templatestring nullable

render_templatesboolean

token_budgetinteger nullable

context_overflow'truncate' | 'adaptive' nullable

auto_run_toolsboolean

forward_tool_callsboolean

metadataobject nullable

Response

Successful Response

situationstring nullable

system_templatestring nullable

summarystring nullable

render_templatesboolean

token_budgetinteger nullable

context_overflow'truncate' | 'adaptive' nullable

auto_run_toolsboolean

forward_tool_callsboolean

idstring uuid required

metadataobject nullable

created_atstring date-time required

updated_atstring date-time required

kindstring nullable

Changes

Changed in 15 of the 44 revisions of this API.20755

Jun 26, 2025a5693caa5db16See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
May 12, 2025088c2ebb898810See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  the request property default value changed from 0 to 0.5
  request-property-default-value-changed
- ○
  the request property default value changed from 0 to 0.5
  request-property-default-value-changed
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  the response's property default value changed from 0 to 0.5 for the status
  response-property-default-value-changed
- ○
  the response's property default value changed from 0 to 0.5 for the status
  response-property-default-value-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 3, 20251f91c7da543815See the full diff
- ▲
  the request property const value hybrid was added
  request-property-const-added
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  the request property default value changed from 0.75 to 0.5
  request-property-default-value-changed
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  the response property const value hybrid was added for the status
  response-property-const-added
- ○
  the response's property default value changed from 0.75 to 0.5 for the status
  response-property-default-value-changed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 1, 20255760ee26a52a11See the full diff
- ▲
  removed from the request property anyOf list
  request-property-any-of-removed
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 28, 20254d9d1f8b357a13See the full diff
- ▲
  removed from the request property anyOf list
  request-property-any-of-removed
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 27, 2025bf9190a8aea013See the full diff
- ▲
  removed from the request property anyOf list
  request-property-any-of-removed
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 26, 2025e01e4f400de263See the full diff
- ▲
  the // request property's min was increased to 100.00
  request-property-min-increased
- ▲
  the // request property's min was increased to 100.00
  request-property-min-increased
- ▲
  the // request property's min was increased to 100.00
  request-property-min-increased
- ▲
  the // response property's max was increased from 1000.00 to 10000.00 for the response status
  response-property-max-increased
- ▲
  the // response property's max was increased from 1000.00 to 10000.00 for the response status
  response-property-max-increased
- ▲
  the // response property's max was increased from 1000.00 to 10000.00 for the response status
  response-property-max-increased
- ○
  the // request property's max was increased from 1000.00 to 10000.00
  request-property-max-increased
- ○
  the // request property's max was increased from 1000.00 to 10000.00
  request-property-max-increased
- ○
  the // request property's max was increased from 1000.00 to 10000.00
  request-property-max-increased
Feb 25, 20251a338af95f8533See the full diff
- ▲
  the response property const value en-US was removed for the status
  response-property-const-removed
- ▲
  the response property const value en-US was removed for the status
  response-property-const-removed
- ▲
  the response property const value en-US was removed for the status
  response-property-const-removed
- ○
  the request property const value en-US was removed
  request-property-const-removed
- ○
  the request property const value en-US was removed
  request-property-const-removed
- ○
  the request property const value en-US was removed
  request-property-const-removed
Feb 25, 20252f61540b4f3d46See the full diff
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
Feb 24, 20250ddb64e7a59813See the full diff
- ▲
  removed from the request property anyOf list
  request-property-any-of-removed
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (15 revisions)