{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/firetiger/json-schema/firetiger-post-firetiger-nxagent-v2-agentservice-createsession-request-schema.json",
  "title": "PostFiretigerNxagentV2AgentserviceCreatesessionRequest",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/firetiger-openapi-generated.yml#/components/schemas/PostFiretigerNxagentV2AgentserviceCreatesessionRequest",
  "type": "object",
  "properties": {
    "parent": {
      "type": "string",
      "description": "Parent agent resource name (agents/{agent})"
    },
    "session_id": {
      "type": "string",
      "description": "Session ID to use. If not provided, the server generates one."
    },
    "initial_messages": {
      "type": "string",
      "description": "Initial messages to write to the session upon creation"
    },
    "associated_resources": {
      "type": "string",
      "description": "Resource names to link to this session"
    },
    "incognito": {
      "type": "boolean",
      "description": "Hide from normal listings; write operations are skipped"
    },
    "automated": {
      "type": "boolean",
      "description": "Flag the session as started by automation (scheduled run, trigger)"
    },
    "bash_prelude": {
      "type": "string",
      "description": "Bash script prepended invisibly to every bash tool call in this session"
    },
    "inputs": {
      "type": "string",
      "description": "Typed input values for the entry task"
    },
    "dry_run": {
      "type": "boolean",
      "description": "Run the session in dry-run mode for backtesting"
    },
    "title": {
      "type": "string",
      "description": "Human-readable display name for the session"
    },
    "openaicompat_provider": {
      "type": "string",
      "description": "Per-session OpenAI-compatible provider override"
    },
    "openaicompat_model": {
      "type": "string",
      "description": "Model ID for the openaicompat_provider"
    },
    "openaicompat_reasoning_effort": {
      "type": "string",
      "description": "Reasoning effort for models that support it: low, medium, or high"
    }
  },
  "required": [
    "parent"
  ]
}