Struct CreateSessionRequest 

pub struct CreateSessionRequest {
    pub system_prompt: Option<String>,
    pub append_system_prompt: Option<String>,
    pub session_name: Option<String>,
    pub max_steps: Option<u32>,
    pub thinking_budget: Option<u32>,
    pub permission_mode: Option<String>,
    pub max_budget_usd: Option<f64>,
}

Request body for POST /sessions.

Fields

system_prompt: Option<String>

append_system_prompt: Option<String>

Append additional text to the server’s default system prompt instead of replacing it. Ignored when system_prompt is also provided.

session_name: Option<String>

Human-readable display name for the session (shown in session list / resume picker).

max_steps: Option<u32>

Maximum number of steps (tool calls) allowed in this session.

thinking_budget: Option<u32>

Extended-thinking token budget for models that support it (e.g. Anthropic claude-3-7). 0 disables thinking.

permission_mode: Option<String>

Permission mode: "default", "auto", "strict", or "bypass".

max_budget_usd: Option<f64>

Maximum total API spend in USD for this session. Agent stops after any turn that would exceed this limit.

Trait Implementations

impl Debug for CreateSessionRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CreateSessionRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.