Skip to main content
GET
/
api
/
v0
/
sessions
/
{sessionId}
Get a session
curl --request GET \
  --url https://api.factory.ai/api/v0/sessions/{sessionId} \
  --header 'Authorization: Bearer <token>'
{
  "sessionId": "<string>",
  "status": "idle",
  "messageCount": 123,
  "createdAt": 123,
  "updatedAt": 123,
  "title": "<string>",
  "completedAt": 123,
  "computerId": "<string>",
  "sessionSettings": {
    "model": "<string>",
    "reasoningEffort": "none",
    "interactionMode": "auto",
    "autonomyLevel": "off",
    "autonomyMode": "normal",
    "specModeModel": "<string>",
    "specModeReasoningEffort": "none",
    "providerLock": "anthropic",
    "providerLockTimestamp": "<string>",
    "apiProviderLock": "bedrock",
    "assistantActiveTimeMs": 123,
    "tokenUsage": {
      "inputTokens": 123,
      "outputTokens": 123,
      "cacheCreationTokens": 123,
      "cacheReadTokens": 123,
      "thinkingTokens": 123
    },
    "archivedAt": "<string>",
    "tags": [
      {
        "name": "<string>",
        "metadata": {}
      }
    ],
    "enabledToolIds": [
      "<string>"
    ]
  }
}

Authorizations

Authorization
string
header
required

Factory API key or JWT token for authentication

Path Parameters

sessionId
string
required

Session ID

Response

Response for status 200

sessionId
string
required

Session ID

status
enum<string>
required

Current session execution status

Available options:
idle,
pending,
running
messageCount
integer
required

Number of messages in session

createdAt
integer
required

Creation timestamp (Unix ms)

updatedAt
integer
required

Last update timestamp (Unix ms)

title
string

Session title

completedAt
integer

Completion timestamp (Unix ms)

computerId
string

Connected computer ID

sessionSettings
object