Skip to main content
POST
/
api
/
v0
/
sessions
Create a session
curl --request POST \
  --url https://api.factory.ai/api/v0/sessions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "templateId": "<string>",
  "model": "claude-3-5-sonnet-20241022",
  "reasoningEffort": "none",
  "autonomyLevel": "normal"
}
'
{
  "id": "<string>",
  "status": "idle",
  "messageCount": 123,
  "createdAt": 123,
  "updatedAt": 123,
  "title": "<string>",
  "completedAt": 123,
  "model": "claude-3-5-sonnet-20241022",
  "reasoningEffort": "none",
  "autonomyLevel": "normal",
  "templateId": "<string>",
  "machineId": "<string>"
}

Authorizations

X-API-Key
string
header
required

Factory API key for authentication

Body

application/json
templateId
string
required

Cloud machine template ID to connect

model
enum<string>

Model ID

Available options:
claude-3-5-sonnet-20241022,
claude-3-7-sonnet-20250219,
claude-sonnet-4-20250514,
claude-opus-4-1-20250805,
claude-3-5-haiku-20241022,
claude-sonnet-4-5-20250929,
claude-opus-4-5-20251101,
claude-haiku-4-5-20251001,
gpt-5-2025-08-07,
gpt-5-mini-2025-08-07,
gpt-5-nano-2025-08-07,
gpt-5-codex,
gpt-5.1,
gpt-5.1-codex,
gpt-5.1-codex-max,
gpt-5.1-codex-mini,
gpt-5.2,
gemini-2.5-flash,
gemini-2.5-pro,
gemini-3-pro-preview,
gemini-3-flash-preview,
garnet-12-02,
grok-4-0709,
grok-code-fast-1,
glm-4.6,
glm-4.7
reasoningEffort
enum<string>

Reasoning effort level for the session

Available options:
none,
dynamic,
off,
minimal,
low,
medium,
high,
xhigh
autonomyLevel
enum<string>
Available options:
normal,
spec,
auto-low,
auto-medium,
auto-high

Response

Response for status 201

id
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)

model
enum<string>

Model ID

Available options:
claude-3-5-sonnet-20241022,
claude-3-7-sonnet-20250219,
claude-sonnet-4-20250514,
claude-opus-4-1-20250805,
claude-3-5-haiku-20241022,
claude-sonnet-4-5-20250929,
claude-opus-4-5-20251101,
claude-haiku-4-5-20251001,
gpt-5-2025-08-07,
gpt-5-mini-2025-08-07,
gpt-5-nano-2025-08-07,
gpt-5-codex,
gpt-5.1,
gpt-5.1-codex,
gpt-5.1-codex-max,
gpt-5.1-codex-mini,
gpt-5.2,
gemini-2.5-flash,
gemini-2.5-pro,
gemini-3-pro-preview,
gemini-3-flash-preview,
garnet-12-02,
grok-4-0709,
grok-code-fast-1,
glm-4.6,
glm-4.7
reasoningEffort
enum<string>

Reasoning effort level for the session

Available options:
none,
dynamic,
off,
minimal,
low,
medium,
high,
xhigh
autonomyLevel
enum<string>
Available options:
normal,
spec,
auto-low,
auto-medium,
auto-high
templateId
string

Cloud machine template ID

machineId
string

Connected machine ID