Sign in
sessions

Create Session

Create a session for the authenticated user in the current workspace.

Parameters: body (SessionCreateRequest): Session creation data, including the optional title. identity (LocalScopeDep): Authenticated user and workspace scope. repo (SessionCatalogDep): Session repository used to create the session. prewarm (SessionPrewarmDep): Optional background Sandbox pre-warm trigger.

Returns: SessionDetailResponse: The newly created session details.

post/api/sessions

Request body

titlestring nullable

Response

Successful Response

idstring uuid required
titlestring required
status'active' | 'archived' required
checkpoint_versioninteger required
created_atstring nullable
updated_atstring nullable

Changes

Changed in 5 of the 85 revisions of this API.265

  • 655778279cb11See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 91 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 62e8c152aa181See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 216311cd30ec3See the full diff
    • ●

      deleted the header request parameter Authorization

      request-parameter-removed

    • ●

      deleted the header request parameter X-Fleet-User-Id

      request-parameter-removed

    • ●

      deleted the header request parameter X-Fleet-Workspace-Id

      request-parameter-removed

  • f18c4c8586ca133See the full diff
    • ▲

      removed the required property turn_count from the response with the 201 status

      response-required-property-removed

    • ●

      removed the optional property detail from the response with the 422 status

      response-optional-property-removed

    • ●

      added the new active enum value to the status response property for the response status 201

      response-property-enum-value-added

    • ●

      added the new archived enum value to the status response property for the response status 201

      response-property-enum-value-added

    • ○

      api operation id create_session_api_sessions_post removed and replaced with create_session

      api-operation-id-removed

    • ○

      added the required property code to the response with the 422 status

      response-required-property-added

    • ○

      added the required property message to the response with the 422 status

      response-required-property-added

    This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1afc045b25c01See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 136 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog