Sign in
Sessions

Create a session

Creates a new session with the specified configuration. This feature is enabled for selected organizations only.

post/api/v0/sessions

Request body

computerIdstring required

Computer ID to connect

cwdstring

Working directory for the session on the computer.

Response

Response for status 201

sessionIdstring required

Session ID

parent_session_idstring

Immediate parent session ID for a Task subagent, if one exists

titlestring

Session title

status'idle' | 'pending' | 'running' required

Current session execution status

messageCountinteger required

Number of messages in session

createdAtinteger required

Creation timestamp (Unix ms)

updatedAtinteger required

Last update timestamp (Unix ms)

completedAtinteger

Completion timestamp (Unix ms)

computerIdstring

Connected computer ID

factoryCreditsnumber

Total Factory credits consumed by the session and its subagents

Changes

Changed in 25 of the 34 revisions of this API.175376

  • a11cdfab8da666See the full diff
    • ●

      added the new claude-sonnet-5-5 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-5.6-luna-flex enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-5.6-terra-flex enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-6-astra-flex enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-6-luna-flex enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-6-sol-flex enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new claude-sonnet-5-5 enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-5.6-luna-flex enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-5.6-terra-flex enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-6-astra-flex enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-6-luna-flex enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-6-sol-flex enum value to the request property //

      request-property-enum-value-added

  • b73121146c951See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 4c7a84680cd444See the full diff
    • ●

      added the new gpt-6-luna enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-6-sol enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-flare enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-sunburst enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new gpt-6-luna enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-6-sol enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst enum value to the request property //

      request-property-enum-value-added

  • 415bff082e8133See the full diff
    • ●

      added the new claude-opus-5-5 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new claude-opus-5-5-fast enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new grok-4.7 enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new claude-opus-5-5 enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new claude-opus-5-5-fast enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new grok-4.7 enum value to the request property //

      request-property-enum-value-added

  • 15889611fbe222See the full diff
    • ●

      added the new mistral-medium-3.5 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new together enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the new mistral-medium-3.5 enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new together enum value to the request property /

      request-property-enum-value-added

  • 932e1abfde8e22See the full diff
    • ●

      added the new azure_anthropic enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new deepseek-v4.1-flash enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new azure_anthropic enum value to the request property /

      request-property-enum-value-added

    • ○

      added the new deepseek-v4.1-flash enum value to the request property //

      request-property-enum-value-added

  • 2b31c104e8d71See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 231a06e0244011See the full diff
    • ●

      added the new qwen3.8-max enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new qwen3.8-max enum value to the request property //

      request-property-enum-value-added

  • b8a9b7beab682See the full diff
    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

  • 5e5ad4346c2911See the full diff
    • ●

      added the new gpt-6-astra enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new gpt-6-astra enum value to the request property //

      request-property-enum-value-added