{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/docsbot-ai/json-schema/docsbot-ai-research-start-request-schema.json",
  "title": "ResearchStartRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/docsbot-ai-openapi.json#/components/schemas/ResearchStartRequest",
  "properties": {
    "question": {
      "type": "string",
      "title": "The research question to clarify or run"
    },
    "model": {
      "type": "string",
      "enum": [
        "gpt-6-astra",
        "gpt-6.1-sol",
        "gpt-6.1-terra",
        "gpt-6-sol",
        "gpt-6-luna",
        "gpt-5.4-mini",
        "gpt-5.5",
        "gpt-5.6-sol",
        "gpt-5.6-luna",
        "o3",
        "o4-mini"
      ],
      "title": "Model",
      "description": "Deep research model tier. gpt-6-luna is the default efficient option; gpt-5.4-mini remains available for legacy requests; gpt-6.1-sol is balanced; gpt-6-astra is most capable. Legacy values o3/o4-mini are accepted as aliases.",
      "default": "gpt-6-luna"
    },
    "web_search": {
      "type": "boolean",
      "title": "Web Search",
      "description": "Enable web search tool for deep research",
      "default": false
    },
    "code_interpreter": {
      "type": "boolean",
      "title": "Code Interpreter",
      "description": "Enable code interpreter tool",
      "default": false
    },
    "docs_search": {
      "type": "boolean",
      "title": "Docs Search",
      "description": "Enable documentation search tool (default true)",
      "default": true
    },
    "question_history": {
      "type": "boolean",
      "title": "Question History",
      "description": "Enable question history tool for firestore search (default false)",
      "default": false
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata",
      "description": "Optional user metadata. Keys 'name' and 'email' are recognized."
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tags to filter sources by"
    },
    "include_untagged": {
      "type": "boolean",
      "title": "Include untagged sources when filtering by tags",
      "default": true
    }
  },
  "type": "object",
  "required": [
    "question"
  ]
}