Skip to main content
POST
/
api
/
v0
/
sessions
Create a session
curl --request POST \
  --url https://api.factory.ai/api/v0/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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,
    "archivedAt": "<string>",
    "tags": [
      {
        "name": "<string>",
        "metadata": {}
      }
    ],
    "enabledToolIds": [
      "<string>"
    ]
  }
}
'
{
  "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

Body

application/json
computerId
string
required

Computer ID to connect

sessionSettings
object

Response

Response for status 201

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