メインコンテンツへスキップ
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>"
    ],
    "disabledToolIds": [
      "<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>"
    ],
    "disabledToolIds": [
      "<string>"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.factory.ai/llms.txt

Use this file to discover all available pages before exploring further.

承認

Authorization
string
header
必須

Factory API key or JWT token for authentication

ボディ

application/json
computerId
string
必須

Computer ID to connect

sessionSettings
object

レスポンス

Response for status 201

sessionId
string
必須

Session ID

status
enum<string>
必須

Current session execution status

利用可能なオプション:
idle,
pending,
running
messageCount
integer
必須

Number of messages in session

createdAt
integer
必須

Creation timestamp (Unix ms)

updatedAt
integer
必須

Last update timestamp (Unix ms)

title
string

Session title

completedAt
integer

Completion timestamp (Unix ms)

computerId
string

Connected computer ID

sessionSettings
object