Sessions

Get a session

Changed on

Returns detailed session information including settings and stats. This feature is enabled for selected organizations only.

get/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

Query parameters

computerIdstring

Computer ID to query directly

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