POST /api/sessions — tlbx-api

Ai.Tlbx.MidTerm.OpenApi

post/api/sessions

Request body

colsinteger required

rowsinteger required

shellstring nullable

workingDirectorystring nullable

spaceIdstring nullable

workspacePathstring nullable

surfacestring nullable

launchCommandstring nullable

launchRequestIdstring nullable

Response

idstring required

pidinteger required

createdAtstring date-time required

isRunningboolean required

exitCodeinteger nullable required

colsinteger required

rowsinteger required

shellTypestring required

namestring nullable required

terminalTitlestring nullable required

topicstring nullable required

notesstring nullable required

manuallyNamedboolean required

currentDirectorystring nullable required

foregroundPidinteger nullable required

foregroundNamestring nullable required

foregroundCommandLinestring nullable required

foregroundDisplayNamestring nullable required

foregroundProcessIdentitystring nullable required

orderinteger required

parentSessionIdstring nullable required

bookmarkIdstring nullable required

spaceIdstring nullable required

workspacePathstring nullable required

surfacestring nullable required

isAdHocboolean required

agentControlledboolean required

appServerControlOnlyboolean required

profileHintstring nullable required

appServerControlResumeThreadIdstring nullable required

hasAppServerControlHistoryboolean required

Changes

Changed in 10 of the 63 revisions of this API.13318

Aug 27, 202604072327b4e01See the full diff
- ○
  added the new optional request property oneOf[CreateSessionRequest]/launchRequestId
  new-optional-request-property
Aug 13, 20261ec1b55502431See the full diff
- ○
  added the new optional request property oneOf[CreateSessionRequest]/launchCommand
  new-optional-request-property
May 13, 2026f43ccea8bcc51See the full diff
- ○
  added the required property topic to the response with the 200 status
  response-required-property-added
May 10, 2026ec6725586e4333See the full diff
- ▲
  removed the required property hasLensHistory from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property lensOnly from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property lensResumeThreadId from the response with the 200 status
  response-required-property-removed
- ○
  added the required property appServerControlOnly to the response with the 200 status
  response-required-property-added
- ○
  added the required property appServerControlResumeThreadId to the response with the 200 status
  response-required-property-added
- ○
  added the required property hasAppServerControlHistory to the response with the 200 status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 6, 2026885b130676921See the full diff
- ○
  added the required property notes to the response with the 200 status
  response-required-property-added
Apr 25, 202687834ab1254b1See the full diff
- ▲
  removed the required property notes from the response with the 200 status
  response-required-property-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 25, 2026cbbe49e2b3e21See the full diff
- ○
  added the required property notes to the response with the 200 status
  response-required-property-added
Apr 10, 20262dab040c6e907See the full diff
- ○
  added the new optional request property oneOf[CreateSessionRequest]/spaceId
  new-optional-request-property
- ○
  added the new optional request property oneOf[CreateSessionRequest]/surface
  new-optional-request-property
- ○
  added the new optional request property oneOf[CreateSessionRequest]/workspacePath
  new-optional-request-property
- ○
  added the required property isAdHoc to the response with the 200 status
  response-required-property-added
- ○
  added the required property spaceId to the response with the 200 status
  response-required-property-added
- ○
  added the required property surface to the response with the 200 status
  response-required-property-added
- ○
  added the required property workspacePath to the response with the 200 status
  response-required-property-added
Apr 6, 2026704da358d8341See the full diff
- ○
  added the required property lensResumeThreadId to the response with the 200 status
  response-required-property-added
Mar 27, 2026536b8636ac1e932See the full diff
- ▲
  removed the required property appServerControlOnly from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property appServerControlResumeThreadId from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property hasAppServerControlHistory from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property isAdHoc from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property notes from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property spaceId from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property surface from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property topic from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property workspacePath from the response with the 200 status
  response-required-property-removed
- ●
  removed the request property oneOf[CreateSessionRequest]/spaceId
  request-property-removed
- ●
  removed the request property oneOf[CreateSessionRequest]/surface
  request-property-removed
- ●
  removed the request property oneOf[CreateSessionRequest]/workspacePath
  request-property-removed
- ○
  added the required property hasLensHistory to the response with the 200 status
  response-required-property-added
- ○
  added the required property lensOnly to the response with the 200 status
  response-required-property-added
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history