POST /v1/sessions
Create a session
Open a new crabcode session. A session holds multiple Runs, where each Run is one instruction-to-execution loop.
Parameters
workspace_id*stringTarget workspace ID.
modelstringOverride the default model.
instructionsstringExtra instructions for this session.
budget_usdnumberMax budget for this session (USD).
Response
{
id: "ses_9f31a2b4",
object: "session",
workspace_id: "ws_2a8c...",
model: "claude-sonnet-4.5",
udget_usd: 5.00,
spent_usd: 0.00,
created_at: 1716250341
}{
id: "ses_9f31a2b4",
object: "session",
workspace_id: "ws_2a8c...",
model: "claude-sonnet-4.5",
udget_usd: 5.00,
spent_usd: 0.00,
created_at: 1716250341
}