Sessions

Update a session

Changed on

Updates session configuration such as model and reasoning effort. This feature is enabled for selected organizations only.

patch/api/v0/sessions/{sessionId}

Request

  • Base URL: https://api.factory.ai
  • URL: https://api.factory.ai/api/v0/sessions/{sessionId}
  • Auth: HTTP bearer

Path parameters

sessionIdstring required

Session ID

Request body

Response

Response for status 200

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

  • dd43fbb08a00Revision changes
    • info

      removed the direct_and_script enum value from the / response property for the response status

  • 030cbbf34315Revision changes
    • warning

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

    • warning

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

    • warning

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