{"openapi":"3.1.0","info":{"title":"agents","summary":"agents OpenAPI","version":"1.0.0"},"paths":{"/{organization}/{project}/action_board/process":{"post":{"tags":["Action Board"],"summary":"Process a single item with the Action Board agent ","description":"Retrieve actions from ActionBoard for your projects.","operationId":"_wrapper__organization___project__action_board_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__action_board_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionBoardProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/action_board/batch_process":{"post":{"tags":["Action Board"],"summary":"Process a batch of items with the Action Board agent","description":"Retrieve actions from ActionBoard for your projects.","operationId":"_wrapper__organization___project__action_board_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__action_board_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ActionBoardProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Action Board Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/agentic_catalog_sources/process":{"post":{"tags":["Agentic Catalog Sources"],"summary":"Process a single item with the Agentic Catalog Sources agent ","description":"List every source configured on a project's AgenticCatalog, with its name,\n description, config, and destinations.\n\n Call this BEFORE any query about an AgenticCatalog table when the user has not named a\n source. Those tables (`agentic_catalog_sources_pull`,\n `agentic_catalog_destinations_push`, `agentic_catalog_source__v`) hold\n every source of the project mixed together, so an organization and project alone do not\n identify what to read -- and picking a source yourself silently answers a different\n question than the one asked.\n\n If this returns more than one source, ASK THE USER which one they mean rather than\n choosing. If it returns exactly one, use it. `id` is the `source_id` filter;\n `destinations[].type` is the `destination` filter on the push table. Do not invent\n a destination that is not listed.\n\n This is the authoritative list. Do NOT substitute `SELECT DISTINCT source_id` on a\n BigQuery table: that only sees sources which have landed a pull, so it omits sources\n that are configured but never pulled, and sources whose pulls are not reaching BigQuery.\n\n Listing is all this tool does. Once you have the source, answer the actual question with\n the `tables_*` tools, filtering on `source_id`.","operationId":"_wrapper__organization___project__agentic_catalog_sources_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__agentic_catalog_sources_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgenticCatalogSourcesProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/agentic_catalog_sources/batch_process":{"post":{"tags":["Agentic Catalog Sources"],"summary":"Process a batch of items with the Agentic Catalog Sources agent","description":"List every source configured on a project's AgenticCatalog, with its name,\n description, config, and destinations.\n\n Call this BEFORE any query about an AgenticCatalog table when the user has not named a\n source. Those tables (`agentic_catalog_sources_pull`,\n `agentic_catalog_destinations_push`, `agentic_catalog_source__v`) hold\n every source of the project mixed together, so an organization and project alone do not\n identify what to read -- and picking a source yourself silently answers a different\n question than the one asked.\n\n If this returns more than one source, ASK THE USER which one they mean rather than\n choosing. If it returns exactly one, use it. `id` is the `source_id` filter;\n `destinations[].type` is the `destination` filter on the push table. Do not invent\n a destination that is not listed.\n\n This is the authoritative list. Do NOT substitute `SELECT DISTINCT source_id` on a\n BigQuery table: that only sees sources which have landed a pull, so it omits sources\n that are configured but never pulled, and sources whose pulls are not reaching BigQuery.\n\n Listing is all this tool does. Once you have the source, answer the actual question with\n the `tables_*` tools, filtering on `source_id`.","operationId":"_wrapper__organization___project__agentic_catalog_sources_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__agentic_catalog_sources_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/AgenticCatalogSourcesProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Agentic Catalog Sources Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/ai_gateway/process":{"post":{"tags":["AI Gateway"],"summary":"Process a single item with the AI Gateway agent ","description":"Generate structured output from unstructured text input based on\n configurable item definitions. It can extract specific information types (strings,\n numbers, booleans) from text according to custom instructions.\n\n Supports both OpenAI models (gpt-5.6-luna, gpt-5.6-terra, gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, gpt-5.2, gpt-5.1, gpt-5-mini, gpt-5-nano) and\n Gemini models (gemini-3.1-pro-preview, gemini-3-flash-preview, gemini-3.1-flash-lite, gemini-3.5-flash).\n\n Can also use other agents as tools for complex reasoning tasks.","operationId":"_wrapper__organization___project__ai_gateway_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__ai_gateway_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LLMWrapperProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/ai_gateway/batch_process":{"post":{"tags":["AI Gateway"],"summary":"Process a batch of items with the AI Gateway agent","description":"Generate structured output from unstructured text input based on\n configurable item definitions. It can extract specific information types (strings,\n numbers, booleans) from text according to custom instructions.\n\n Supports both OpenAI models (gpt-5.6-luna, gpt-5.6-terra, gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, gpt-5.2, gpt-5.1, gpt-5-mini, gpt-5-nano) and\n Gemini models (gemini-3.1-pro-preview, gemini-3-flash-preview, gemini-3.1-flash-lite, gemini-3.5-flash).\n\n Can also use other agents as tools for complex reasoning tasks.","operationId":"_wrapper__organization___project__ai_gateway_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__ai_gateway_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/LLMWrapperProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Ai Gateway Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/batch_run/process":{"post":{"tags":["Batch Run"],"summary":"Process a single item with the Batch Run agent ","description":"Run one tool over many records at once.\n\n This is the only way to fan a tool out: every other tool takes exactly one item.\n\n Sources: `rows` (records in the call itself), `sql` (a BigQuery query),\n `table` (a whole catalog table), `file` (a CSV/TSV uploaded at\n https://app.botify.com/:organization/:project/o/storage/tmp, or the output of\n a previous batch).\n\n Small sources run immediately and return their results. Larger ones run as a\n background job: you get a job_id to poll with batch_status, and the records\n never enter this conversation.\n\n The output is a temporary JSONL file whose URL is directly usable as the\n `file` source of a next batch, which is how several tools are chained. Each\n line is {row, item, response, error} -- the original row and mapped item are\n both kept, so results stay attributable and source columns survive chaining.\n\n Use tool_documentation on the target tool first: item_map has to match its\n item schema. Use dry_run to check a mapping against real records before\n paying for the whole source.","operationId":"_wrapper__organization___project__batch_run_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__batch_run_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRunResult"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/batch_run/batch_process":{"post":{"tags":["Batch Run"],"summary":"Process a batch of items with the Batch Run agent","description":"Run one tool over many records at once.\n\n This is the only way to fan a tool out: every other tool takes exactly one item.\n\n Sources: `rows` (records in the call itself), `sql` (a BigQuery query),\n `table` (a whole catalog table), `file` (a CSV/TSV uploaded at\n https://app.botify.com/:organization/:project/o/storage/tmp, or the output of\n a previous batch).\n\n Small sources run immediately and return their results. Larger ones run as a\n background job: you get a job_id to poll with batch_status, and the records\n never enter this conversation.\n\n The output is a temporary JSONL file whose URL is directly usable as the\n `file` source of a next batch, which is how several tools are chained. Each\n line is {row, item, response, error} -- the original row and mapped item are\n both kept, so results stay attributable and source columns survive chaining.\n\n Use tool_documentation on the target tool first: item_map has to match its\n item schema. Use dry_run to check a mapping against real records before\n paying for the whole source.","operationId":"_wrapper__organization___project__batch_run_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__batch_run_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/BatchRunResult"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Batch Run Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/botify_config/process":{"post":{"tags":["Botify Config"],"summary":"Process a single item with the Botify Config agent ","description":"Retrieve configuration information for Botify products.\n \n Supports:\n - SpeedWorkers: Get beam domain, hosts, production version, crawl stats, and interceptor configs\n - PageWorkers: Get modules status and deployment information\n - Botify Core: Get project configuration including URL, timezone, allowed domains for SiteCrawler, Configured analytics providers (Google Analytics, Adobe Analytics..), Google Search Console properties...\n \n Multiple products can be requested in a single call.","operationId":"_wrapper__organization___project__botify_config_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__botify_config_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotifyConfigProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/botify_config/batch_process":{"post":{"tags":["Botify Config"],"summary":"Process a batch of items with the Botify Config agent","description":"Retrieve configuration information for Botify products.\n \n Supports:\n - SpeedWorkers: Get beam domain, hosts, production version, crawl stats, and interceptor configs\n - PageWorkers: Get modules status and deployment information\n - Botify Core: Get project configuration including URL, timezone, allowed domains for SiteCrawler, Configured analytics providers (Google Analytics, Adobe Analytics..), Google Search Console properties...\n \n Multiple products can be requested in a single call.","operationId":"_wrapper__organization___project__botify_config_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__botify_config_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfigProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Botify Config Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/botify_data/process":{"post":{"tags":["Botify Data"],"summary":"Process a single item with the Botify Data agent ","description":"Query your Botify data.","operationId":"_wrapper__organization___project__botify_data_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__botify_data_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BQLProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/botify_data/batch_process":{"post":{"tags":["Botify Data"],"summary":"Process a batch of items with the Botify Data agent","description":"Query your Botify data.","operationId":"_wrapper__organization___project__botify_data_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__botify_data_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/BQLProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Botify Data Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/calculator/process":{"post":{"tags":["Calculator"],"summary":"Process a single item with the Calculator agent ","description":"Perform basic arithmetic operations (add, subtract, multiply, divide).","operationId":"_wrapper__organization___project__calculator_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__calculator_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculatorProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/calculator/batch_process":{"post":{"tags":["Calculator"],"summary":"Process a batch of items with the Calculator agent","description":"Perform basic arithmetic operations (add, subtract, multiply, divide).","operationId":"_wrapper__organization___project__calculator_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__calculator_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/CalculatorProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Calculator Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/chatgpt_websearch/process":{"post":{"tags":["Chatgpt Websearch"],"summary":"Process a single item with the Chatgpt Websearch agent ","description":"Use ChatGPT's web interface to search for information and get responses. This agent\n interacts with ChatGPT's web interface and retrieve answers\n to queries in real-time.\n\n This agent can help you:\n - Get answers to questions from ChatGPT's web interface\n - Access ChatGPT's knowledge and capabilities through web scraping\n - Get location-specific results by specifying a country code","operationId":"_wrapper__organization___project__chatgpt_websearch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__chatgpt_websearch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGPTWebSearchProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/chatgpt_websearch/batch_process":{"post":{"tags":["Chatgpt Websearch"],"summary":"Process a batch of items with the Chatgpt Websearch agent","description":"Use ChatGPT's web interface to search for information and get responses. This agent\n interacts with ChatGPT's web interface and retrieve answers\n to queries in real-time.\n\n This agent can help you:\n - Get answers to questions from ChatGPT's web interface\n - Access ChatGPT's knowledge and capabilities through web scraping\n - Get location-specific results by specifying a country code","operationId":"_wrapper__organization___project__chatgpt_websearch_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__chatgpt_websearch_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ChatGPTWebSearchProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Chatgpt Websearch Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/embed/process":{"post":{"tags":["Embed"],"summary":"Process a single item with the Embed agent ","description":"Generate embeddings from text input. Currently supports text-multilingual-embedding-002 model. Returns a vector representation of the input text that can be used for semantic search, similarity comparison, and other machine learning tasks.","operationId":"_wrapper__organization___project__embed_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__embed_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbedProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/embed/batch_process":{"post":{"tags":["Embed"],"summary":"Process a batch of items with the Embed agent","description":"Generate embeddings from text input. Currently supports text-multilingual-embedding-002 model. Returns a vector representation of the input text that can be used for semantic search, similarity comparison, and other machine learning tasks.","operationId":"_wrapper__organization___project__embed_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__embed_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/EmbedProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Embed Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/get_credit_usage/process":{"post":{"tags":["Credit Consumption"],"summary":"Process a single item with the Credit Consumption agent ","description":"Report how far through its agent credit allowance the project is, over both\n windows that carry one: the day and the calendar month.\n\n The allowance is a project-wide pool shared by every member, not a personal\n one, and passing it warns rather than blocks: calls keep being served up to a\n higher ceiling. Reading consumption through this agent is itself free and\n consumes no credits.","operationId":"_wrapper__organization___project__get_credit_usage_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__get_credit_usage_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCreditUsageProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/get_credit_usage/batch_process":{"post":{"tags":["Credit Consumption"],"summary":"Process a batch of items with the Credit Consumption agent","description":"Report how far through its agent credit allowance the project is, over both\n windows that carry one: the day and the calendar month.\n\n The allowance is a project-wide pool shared by every member, not a personal\n one, and passing it warns rather than blocks: calls keep being served up to a\n higher ceiling. Reading consumption through this agent is itself free and\n consumes no credits.","operationId":"_wrapper__organization___project__get_credit_usage_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__get_credit_usage_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GetCreditUsageProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Get Credit Usage Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ads_keyword_suggestions/process":{"post":{"tags":["Google Ads Keyword Suggestions"],"summary":"Process a single item with the Google Ads Keyword Suggestions agent ","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google Ads data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__google_ads_keyword_suggestions_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ads_keyword_suggestions_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ads_keyword_suggestions/batch_process":{"post":{"tags":["Google Ads Keyword Suggestions"],"summary":"Process a batch of items with the Google Ads Keyword Suggestions agent","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google Ads data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__google_ads_keyword_suggestions_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ads_keyword_suggestions_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Ads Keyword Suggestions Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ads_search_volume/process":{"post":{"tags":["Google Ads Search Volume"],"summary":"Process a single item with the Google Ads Search Volume agent ","description":"This agent retrieves Google Ads search volume data for specified keywords.\n \n It provides information including:\n - Monthly average search volume\n - Competition level and index\n - Cost per click (CPC)\n - Top of page bid estimates\n - Monthly search volume history\n - Location and language targeting data\n \n The agent supports location and language targeting to get region-specific search volume data.","operationId":"_wrapper__organization___project__google_ads_search_volume_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ads_search_volume_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchVolumeProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ads_search_volume/batch_process":{"post":{"tags":["Google Ads Search Volume"],"summary":"Process a batch of items with the Google Ads Search Volume agent","description":"This agent retrieves Google Ads search volume data for specified keywords.\n \n It provides information including:\n - Monthly average search volume\n - Competition level and index\n - Cost per click (CPC)\n - Top of page bid estimates\n - Monthly search volume history\n - Location and language targeting data\n \n The agent supports location and language targeting to get region-specific search volume data.","operationId":"_wrapper__organization___project__google_ads_search_volume_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ads_search_volume_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAdsSearchVolumeProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Ads Search Volume Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ai_mode/process":{"post":{"tags":["Google AI Mode"],"summary":"Process a single item with the Google AI Mode agent ","description":"Retrieve AI-powered search results from Google AI Mode.\n Get comprehensive AI-generated answers, featured snippets, and search insights for any query.","operationId":"_wrapper__organization___project__google_ai_mode_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ai_mode_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAiModeProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ai_mode/batch_process":{"post":{"tags":["Google AI Mode"],"summary":"Process a batch of items with the Google AI Mode agent","description":"Retrieve AI-powered search results from Google AI Mode.\n Get comprehensive AI-generated answers, featured snippets, and search insights for any query.","operationId":"_wrapper__organization___project__google_ai_mode_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ai_mode_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiModeProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Ai Mode Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ai_overview/process":{"post":{"tags":["Google Ai Overview"],"summary":"Process a single item with the Google Ai Overview agent ","description":"Fetch the AI-powered summary from Google AI Overview, a snapshot of key information about a topic or question with links.","operationId":"_wrapper__organization___project__google_ai_overview_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ai_overview_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAiOverviewProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_ai_overview/batch_process":{"post":{"tags":["Google Ai Overview"],"summary":"Process a batch of items with the Google Ai Overview agent","description":"Fetch the AI-powered summary from Google AI Overview, a snapshot of key information about a topic or question with links.","operationId":"_wrapper__organization___project__google_ai_overview_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_ai_overview_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiOverviewProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Ai Overview Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_gemini/process":{"post":{"tags":["Google Gemini"],"summary":"Process a single item with the Google Gemini agent ","description":"Retrieve AI-powered search results from Google Gemini.\n Get comprehensive AI-generated answers with structured text, tables,\n and source citations for any query.","operationId":"_wrapper__organization___project__google_gemini_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_gemini_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleGeminiProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_gemini/batch_process":{"post":{"tags":["Google Gemini"],"summary":"Process a batch of items with the Google Gemini agent","description":"Retrieve AI-powered search results from Google Gemini.\n Get comprehensive AI-generated answers with structured text, tables,\n and source citations for any query.","operationId":"_wrapper__organization___project__google_gemini_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_gemini_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleGeminiProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Gemini Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_knowledge_graph/process":{"post":{"tags":["Google Knowledge Graph"],"summary":"Process a single item with the Google Knowledge Graph agent ","description":"Search the Google Knowledge Graph to find information about millions of real-world entities and their relationships, like people, places, organizations, and things.","operationId":"_wrapper__organization___project__google_knowledge_graph_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_knowledge_graph_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleKnowledgeGraphProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_knowledge_graph/batch_process":{"post":{"tags":["Google Knowledge Graph"],"summary":"Process a batch of items with the Google Knowledge Graph agent","description":"Search the Google Knowledge Graph to find information about millions of real-world entities and their relationships, like people, places, organizations, and things.","operationId":"_wrapper__organization___project__google_knowledge_graph_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_knowledge_graph_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleKnowledgeGraphProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Knowledge Graph Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_people_also_ask/process":{"post":{"tags":["Google People Also Ask"],"summary":"Process a single item with the Google People Also Ask agent ","description":"Retrieve the Google 'People Also Ask' questions for a specific query.","operationId":"_wrapper__organization___project__google_people_also_ask_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_people_also_ask_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GooglePeopleAlsoAskProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_people_also_ask/batch_process":{"post":{"tags":["Google People Also Ask"],"summary":"Process a batch of items with the Google People Also Ask agent","description":"Retrieve the Google 'People Also Ask' questions for a specific query.","operationId":"_wrapper__organization___project__google_people_also_ask_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_people_also_ask_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoAskProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google People Also Ask Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_people_also_search/process":{"post":{"tags":["Google People Also Search"],"summary":"Process a single item with the Google People Also Search agent ","description":"Retrieve the Google 'People Also Search' questions for a specific query","operationId":"_wrapper__organization___project__google_people_also_search_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_people_also_search_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GooglePeopleAlsoSearchProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_people_also_search/batch_process":{"post":{"tags":["Google People Also Search"],"summary":"Process a batch of items with the Google People Also Search agent","description":"Retrieve the Google 'People Also Search' questions for a specific query","operationId":"_wrapper__organization___project__google_people_also_search_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_people_also_search_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoSearchProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google People Also Search Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_position_opportunities/process":{"post":{"tags":["Google Position-based Click Opportunities"],"summary":"Process a single item with the Google Position-based Click Opportunities agent ","description":"Analyze potential click gains from improving search ranking positions for specific URLs or keywords.\n \n This agent uses historical Search Console data to calculate the expected additional clicks you could\n gain by improving from your current position to better positions, broken down by device type\n (mobile and desktop/tablet).","operationId":"_wrapper__organization___project__google_position_opportunities_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_position_opportunities_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GooglePositionOpportunitiesProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_position_opportunities/batch_process":{"post":{"tags":["Google Position-based Click Opportunities"],"summary":"Process a batch of items with the Google Position-based Click Opportunities agent","description":"Analyze potential click gains from improving search ranking positions for specific URLs or keywords.\n \n This agent uses historical Search Console data to calculate the expected additional clicks you could\n gain by improving from your current position to better positions, broken down by device type\n (mobile and desktop/tablet).","operationId":"_wrapper__organization___project__google_position_opportunities_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_position_opportunities_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GooglePositionOpportunitiesProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Position Opportunities Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_search/process":{"post":{"tags":["Google Search"],"summary":"Process a single item with the Google Search agent ","description":"Get feature snippets (e.g., Google shopping, images, video, people also search/ask), blue links, and knowledge graphs from real-time Google results.","operationId":"_wrapper__organization___project__google_search_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_search_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSearchProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_search/batch_process":{"post":{"tags":["Google Search"],"summary":"Process a batch of items with the Google Search agent","description":"Get feature snippets (e.g., Google shopping, images, video, people also search/ask), blue links, and knowledge graphs from real-time Google results.","operationId":"_wrapper__organization___project__google_search_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_search_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Search Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_serp/process":{"post":{"tags":["Google SERP"],"summary":"Process a single item with the Google SERP agent ","description":"Fetch the Google SERP for a given query (returns all data)","operationId":"_wrapper__organization___project__google_serp_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_serp_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSearchRawProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_serp/batch_process":{"post":{"tags":["Google SERP"],"summary":"Process a batch of items with the Google SERP agent","description":"Fetch the Google SERP for a given query (returns all data)","operationId":"_wrapper__organization___project__google_serp_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_serp_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchRawProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Serp Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_trends/process":{"post":{"tags":["Google Trends"],"summary":"Process a single item with the Google Trends agent ","description":"Analyze search trend data to understand how interest in specific keywords has changed over time, compare keyword popularity, and discover seasonal trends.","operationId":"_wrapper__organization___project__google_trends_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_trends_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleTrendsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_trends/batch_process":{"post":{"tags":["Google Trends"],"summary":"Process a batch of items with the Google Trends agent","description":"Analyze search trend data to understand how interest in specific keywords has changed over time, compare keyword popularity, and discover seasonal trends.","operationId":"_wrapper__organization___project__google_trends_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_trends_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleTrendsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Trends Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_url_inspection/process":{"post":{"tags":["Google URL Inspection"],"summary":"Process a single item with the Google URL Inspection agent ","description":"Get information about Google's indexed version of a page from the URL Inspection Tool, including indexing problems encountered and structured data, video, linked AMP, and indexability details.","operationId":"_wrapper__organization___project__google_url_inspection_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_url_inspection_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleURLInspectionProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/google_url_inspection/batch_process":{"post":{"tags":["Google URL Inspection"],"summary":"Process a batch of items with the Google URL Inspection agent","description":"Get information about Google's indexed version of a page from the URL Inspection Tool, including indexing problems encountered and structured data, video, linked AMP, and indexability details.","operationId":"_wrapper__organization___project__google_url_inspection_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__google_url_inspection_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/GoogleURLInspectionProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Google Url Inspection Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_code_executor/process":{"post":{"tags":["HTML Executor"],"summary":"Process a single item with the HTML Executor agent ","description":"Execute custom JavaScript extraction functions on HTML content from SiteCrawler.\n\n This agent is optimized for batch processing - when processing multiple URLs,\n they are sent to javascript executor together for better performance.\n\n The JavaScript function should be in the format 'function() { ... }' and has\n access to a `document` object for DOM traversal (querySelector, querySelectorAll, etc.).\n\n If no crawl is specified (analysis_slug in config), the last successful crawl is used.\n Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp\n are resolved from project storage and do not require a crawl.\n\n Each input URL may carry a list of quality control expectations. When set,\n the agent evaluates them against the extracted JSON result and reports, per\n item, whether all expectations passed and the details of any failures.","operationId":"_wrapper__organization___project__html_code_executor_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_code_executor_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTMLExecutorProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_code_executor/batch_process":{"post":{"tags":["HTML Executor"],"summary":"Process a batch of items with the HTML Executor agent","description":"Execute custom JavaScript extraction functions on HTML content from SiteCrawler.\n\n This agent is optimized for batch processing - when processing multiple URLs,\n they are sent to javascript executor together for better performance.\n\n The JavaScript function should be in the format 'function() { ... }' and has\n access to a `document` object for DOM traversal (querySelector, querySelectorAll, etc.).\n\n If no crawl is specified (analysis_slug in config), the last successful crawl is used.\n Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp\n are resolved from project storage and do not require a crawl.\n\n Each input URL may carry a list of quality control expectations. When set,\n the agent evaluates them against the extracted JSON result and reports, per\n item, whether all expectations passed and the details of any failures.","operationId":"_wrapper__organization___project__html_code_executor_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_code_executor_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HTMLExecutorProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Code Executor Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_extract_images/process":{"post":{"tags":["HTML Extract Images"],"summary":"Process a single item with the HTML Extract Images agent ","description":"Extract main images from a webpage (excluding logos, icons, and decorative elements) to analyze visual content, build new web pages, and ensure proper image attribution.\n This agent focuses on important content images and provides image URLs, titles, and copyright information, when available.","operationId":"_wrapper__organization___project__html_extract_images_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_extract_images_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTMLExtractImagesProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_extract_images/batch_process":{"post":{"tags":["HTML Extract Images"],"summary":"Process a batch of items with the HTML Extract Images agent","description":"Extract main images from a webpage (excluding logos, icons, and decorative elements) to analyze visual content, build new web pages, and ensure proper image attribution.\n This agent focuses on important content images and provides image URLs, titles, and copyright information, when available.","operationId":"_wrapper__organization___project__html_extract_images_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_extract_images_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HTMLExtractImagesProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Extract Images Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_extractor_css_selector/process":{"post":{"tags":["HTML Extractor through CSS Selector"],"summary":"Process a single item with the HTML Extractor through CSS Selector agent ","description":"Get the CSS selector for a given element.","operationId":"_wrapper__organization___project__html_extractor_css_selector_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_extractor_css_selector_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlExtractorCssSelectorProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_extractor_css_selector/batch_process":{"post":{"tags":["HTML Extractor through CSS Selector"],"summary":"Process a batch of items with the HTML Extractor through CSS Selector agent","description":"Get the CSS selector for a given element.","operationId":"_wrapper__organization___project__html_extractor_css_selector_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_extractor_css_selector_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HtmlExtractorCssSelectorProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Extractor Css Selector Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_fetch/process":{"post":{"tags":["HTML Fetch"],"summary":"Process a single item with the HTML Fetch agent ","description":"Fetch the HTML of a URL, from the Botify SiteCrawler archive by default, or\n live through a real-time fetch or the rendering farm (which executes the page\n JavaScript) when `origin` asks for it.\n\n The HTML is cleaned before being returned: `remove_tags` drops the listed tags,\n `only_body` keeps the body only and `only_text` strips the markup down to text.","operationId":"_wrapper__organization___project__html_fetch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_fetch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTMLFetchProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_fetch/batch_process":{"post":{"tags":["HTML Fetch"],"summary":"Process a batch of items with the HTML Fetch agent","description":"Fetch the HTML of a URL, from the Botify SiteCrawler archive by default, or\n live through a real-time fetch or the rendering farm (which executes the page\n JavaScript) when `origin` asks for it.\n\n The HTML is cleaned before being returned: `remove_tags` drops the listed tags,\n `only_body` keeps the body only and `only_text` strips the markup down to text.","operationId":"_wrapper__organization___project__html_fetch_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_fetch_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HTMLFetchProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Fetch Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_grep/process":{"post":{"tags":["HTML Grep"],"summary":"Process a single item with the HTML Grep agent ","description":"Fetch the HTML of a given URL and search for one or more expressions in it.\n\n For each occurrence found, the agent returns the matching text along with\n a configurable number of characters of context on each side. Each expression\n can be a literal substring (default) or a Python regular expression, and is\n configured independently (case sensitivity, max matches, context size).","operationId":"_wrapper__organization___project__html_grep_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_grep_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlGrepProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_grep/batch_process":{"post":{"tags":["HTML Grep"],"summary":"Process a batch of items with the HTML Grep agent","description":"Fetch the HTML of a given URL and search for one or more expressions in it.\n\n For each occurrence found, the agent returns the matching text along with\n a configurable number of characters of context on each side. Each expression\n can be a literal substring (default) or a Python regular expression, and is\n configured independently (case sensitivity, max matches, context size).","operationId":"_wrapper__organization___project__html_grep_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_grep_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HtmlGrepProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Grep Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_lang/process":{"post":{"tags":["HTML Lang"],"summary":"Process a single item with the HTML Lang agent ","description":"A simple agent that returns the language of a given HTML page (BCP47 format).\nFirst, we try to read the lang attribute on the html tag.\nIf we don't find it, extract the text from the html and ask to a LLM.","operationId":"_wrapper__organization___project__html_lang_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_lang_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlLangProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_lang/batch_process":{"post":{"tags":["HTML Lang"],"summary":"Process a batch of items with the HTML Lang agent","description":"A simple agent that returns the language of a given HTML page (BCP47 format).\nFirst, we try to read the lang attribute on the html tag.\nIf we don't find it, extract the text from the html and ask to a LLM.","operationId":"_wrapper__organization___project__html_lang_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_lang_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HtmlLangProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Lang Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_pageworkers_preview/process":{"post":{"tags":["HTML PageWorkers Preview"],"summary":"Process a single item with the HTML PageWorkers Preview agent ","description":"Get the preview for PageWorkers descriptor for a selector or templates rendering.","operationId":"_wrapper__organization___project__html_pageworkers_preview_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_pageworkers_preview_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlPageWorkersPreviewProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_pageworkers_preview/batch_process":{"post":{"tags":["HTML PageWorkers Preview"],"summary":"Process a batch of items with the HTML PageWorkers Preview agent","description":"Get the preview for PageWorkers descriptor for a selector or templates rendering.","operationId":"_wrapper__organization___project__html_pageworkers_preview_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_pageworkers_preview_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HtmlPageWorkersPreviewProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Pageworkers Preview Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_question/process":{"post":{"tags":["HTML Question"],"summary":"Process a single item with the HTML Question agent ","description":"Ask about a page's semantic structure, HTML elements, and technical aspects.\n Inquire about HTML tags, DOM structure, meta information, or how to access elements with CSS selectors.\n This agent can also extract and analyze structured data (e.g., JSON-LD, microdata, RDFa), understand semantic hierarchy, find specific attributes or values, and provide insights about a page's technical implementation.","operationId":"_wrapper__organization___project__html_question_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_question_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTMLQuestionProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_question/batch_process":{"post":{"tags":["HTML Question"],"summary":"Process a batch of items with the HTML Question agent","description":"Ask about a page's semantic structure, HTML elements, and technical aspects.\n Inquire about HTML tags, DOM structure, meta information, or how to access elements with CSS selectors.\n This agent can also extract and analyze structured data (e.g., JSON-LD, microdata, RDFa), understand semantic hierarchy, find specific attributes or values, and provide insights about a page's technical implementation.","operationId":"_wrapper__organization___project__html_question_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_question_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HTMLQuestionProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Question Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_structured_data/process":{"post":{"tags":["HTML Structured Data"],"summary":"Process a single item with the HTML Structured Data agent ","description":"Extract structured data from HTML pages in JSON-LD format.","operationId":"_wrapper__organization___project__html_structured_data_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_structured_data_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTMLStructuredDataProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_structured_data/batch_process":{"post":{"tags":["HTML Structured Data"],"summary":"Process a batch of items with the HTML Structured Data agent","description":"Extract structured data from HTML pages in JSON-LD format.","operationId":"_wrapper__organization___project__html_structured_data_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_structured_data_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HTMLStructuredDataProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html Structured Data Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_to_text/process":{"post":{"tags":["HTML To Text"],"summary":"Process a single item with the HTML To Text agent ","description":"A simple agent that returns the text of a given HTML page.\nFirst, we try to extract the text from the html with the readability tool.\nIf we don't find it, extract the text from the html with the beautifulsoup library.","operationId":"_wrapper__organization___project__html_to_text_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_to_text_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlToTextProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/html_to_text/batch_process":{"post":{"tags":["HTML To Text"],"summary":"Process a batch of items with the HTML To Text agent","description":"A simple agent that returns the text of a given HTML page.\nFirst, we try to extract the text from the html with the readability tool.\nIf we don't find it, extract the text from the html with the beautifulsoup library.","operationId":"_wrapper__organization___project__html_to_text_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__html_to_text_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/HtmlToTextProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Html To Text Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_clustering/process":{"post":{"tags":["Keywords Clustering"],"summary":"Process a single item with the Keywords Clustering agent ","description":"This tool groups keywords provided by @KeywordsSuggestions or @KeywordsSuggestionsGoogleAdsPlanner into thematic clusters based on user intent and behavior.\n The clustering reveals content opportunities by combining related terms, considering search volume, competition, and commercial intent.\n These clusters inform content strategy by highlighting topic hierarchies, gaps, and potential site structure improvements.\n Each cluster includes a relevance assessment to guide content prioritization.","operationId":"_wrapper__organization___project__keywords_clustering_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_clustering_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordsClusteringProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_clustering/batch_process":{"post":{"tags":["Keywords Clustering"],"summary":"Process a batch of items with the Keywords Clustering agent","description":"This tool groups keywords provided by @KeywordsSuggestions or @KeywordsSuggestionsGoogleAdsPlanner into thematic clusters based on user intent and behavior.\n The clustering reveals content opportunities by combining related terms, considering search volume, competition, and commercial intent.\n These clusters inform content strategy by highlighting topic hierarchies, gaps, and potential site structure improvements.\n Each cluster includes a relevance assessment to guide content prioritization.","operationId":"_wrapper__organization___project__keywords_clustering_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_clustering_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/KeywordsClusteringProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Keywords Clustering Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_extractor/process":{"post":{"tags":["Keywords Extractor"],"summary":"Process a single item with the Keywords Extractor agent ","description":"Extract top X keywords from given URLs.","operationId":"_wrapper__organization___project__keywords_extractor_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_extractor_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordsExtractorProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_extractor/batch_process":{"post":{"tags":["Keywords Extractor"],"summary":"Process a batch of items with the Keywords Extractor agent","description":"Extract top X keywords from given URLs.","operationId":"_wrapper__organization___project__keywords_extractor_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_extractor_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/KeywordsExtractorProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Keywords Extractor Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_suggestions/process":{"post":{"tags":["Keyword Suggestions"],"summary":"Process a single item with the Keyword Suggestions agent ","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google search data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__keywords_suggestions_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_suggestions_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordsSuggestionsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_suggestions/batch_process":{"post":{"tags":["Keyword Suggestions"],"summary":"Process a batch of items with the Keyword Suggestions agent","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google search data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__keywords_suggestions_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_suggestions_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Keywords Suggestions Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_suggestions_google_ads_planner/process":{"post":{"tags":["Keywords Suggestions From Google Ads Planner"],"summary":"Process a single item with the Keywords Suggestions From Google Ads Planner agent ","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google Ads data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__keywords_suggestions_google_ads_planner_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/keywords_suggestions_google_ads_planner/batch_process":{"post":{"tags":["Keywords Suggestions From Google Ads Planner"],"summary":"Process a batch of items with the Keywords Suggestions From Google Ads Planner agent","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google Ads data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__keywords_suggestions_google_ads_planner_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Keywords Suggestions Google Ads Planner Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/knowledge/process":{"post":{"tags":["Knowledge"],"summary":"Process a single item with the Knowledge agent ","description":"Answer questions about the Botify application to understand product features, technical concepts, and best practices for using Botify effectively.In any case but the build of a query, if user asks what a specific filter means (for example a dimension, metric, or UI filter) and strictly for the meaning, query the Knowledge tool using the filter name plus the keyword “filters”, then explain the filter to the user using the field description and any relevant documentation you find.","operationId":"_wrapper__organization___project__knowledge_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__knowledge_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeAgentProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/knowledge/batch_process":{"post":{"tags":["Knowledge"],"summary":"Process a batch of items with the Knowledge agent","description":"Answer questions about the Botify application to understand product features, technical concepts, and best practices for using Botify effectively.In any case but the build of a query, if user asks what a specific filter means (for example a dimension, metric, or UI filter) and strictly for the meaning, query the Knowledge tool using the filter name plus the keyword “filters”, then explain the filter to the user using the field description and any relevant documentation you find.","operationId":"_wrapper__organization___project__knowledge_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__knowledge_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/KnowledgeAgentProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Knowledge Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/list_annotations/process":{"post":{"tags":["List Annotations"],"summary":"Process a single item with the List Annotations agent ","description":"Retrieve annotations logged on your project.","operationId":"_wrapper__organization___project__list_annotations_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__list_annotations_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAnnotationsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/list_annotations/batch_process":{"post":{"tags":["List Annotations"],"summary":"Process a batch of items with the List Annotations agent","description":"Retrieve annotations logged on your project.","operationId":"_wrapper__organization___project__list_annotations_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__list_annotations_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ListAnnotationsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project List Annotations Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/nearest_page_for_topic/process":{"post":{"tags":["Find Nearest Pages for Topic"],"summary":"Process a single item with the Find Nearest Pages for Topic agent ","description":"Find your five most relevant pages for a given topic from Google search results.\n This can help you evaluate your pages' relevance to identify internal linking opportunities and content optimization.","operationId":"_wrapper__organization___project__nearest_page_for_topic_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__nearest_page_for_topic_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NearestPageForTopicProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/nearest_page_for_topic/batch_process":{"post":{"tags":["Find Nearest Pages for Topic"],"summary":"Process a batch of items with the Find Nearest Pages for Topic agent","description":"Find your five most relevant pages for a given topic from Google search results.\n This can help you evaluate your pages' relevance to identify internal linking opportunities and content optimization.","operationId":"_wrapper__organization___project__nearest_page_for_topic_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__nearest_page_for_topic_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/NearestPageForTopicProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Nearest Page For Topic Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/organic_keyword_suggestions/process":{"post":{"tags":["Organic Keyword Suggestions"],"summary":"Process a single item with the Organic Keyword Suggestions agent ","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google search data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__organic_keyword_suggestions_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__organic_keyword_suggestions_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicKeywordSuggestionsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/organic_keyword_suggestions/batch_process":{"post":{"tags":["Organic Keyword Suggestions"],"summary":"Process a batch of items with the Organic Keyword Suggestions agent","description":"Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google search data.\n This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent.\n This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.","operationId":"_wrapper__organization___project__organic_keyword_suggestions_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__organic_keyword_suggestions_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/OrganicKeywordSuggestionsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Organic Keyword Suggestions Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/pageworkers_generic_urls_actions/process":{"post":{"tags":["PageWorkers Generic URLs Actions"],"summary":"Process a single item with the PageWorkers Generic URLs Actions agent ","description":"This agent creates a PageWorkers optimization for a page from your most recent crawl to update its title, description, or H1 tag.","operationId":"_wrapper__organization___project__pageworkers_generic_urls_actions_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__pageworkers_generic_urls_actions_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageWorkersProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/pageworkers_generic_urls_actions/batch_process":{"post":{"tags":["PageWorkers Generic URLs Actions"],"summary":"Process a batch of items with the PageWorkers Generic URLs Actions agent","description":"This agent creates a PageWorkers optimization for a page from your most recent crawl to update its title, description, or H1 tag.","operationId":"_wrapper__organization___project__pageworkers_generic_urls_actions_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__pageworkers_generic_urls_actions_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/PageWorkersProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Pageworkers Generic Urls Actions Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/perplexity/process":{"post":{"tags":["Perplexity"],"summary":"Process a single item with the Perplexity agent ","description":"Leverage Perplexity AI's robust knowledge base for accurate, current answers to your questions. This agent combines advanced language models with real-time information to provide comprehensive responses with relevant citations.","operationId":"_wrapper__organization___project__perplexity_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__perplexity_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/perplexity/batch_process":{"post":{"tags":["Perplexity"],"summary":"Process a batch of items with the Perplexity agent","description":"Leverage Perplexity AI's robust knowledge base for accurate, current answers to your questions. This agent combines advanced language models with real-time information to provide comprehensive responses with relevant citations.","operationId":"_wrapper__organization___project__perplexity_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__perplexity_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Perplexity Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/project_metadata/process":{"post":{"tags":["Project Memory"],"summary":"Process a single item with the Project Memory agent ","description":"Store and retrieve key project metadata, such as tone of voice, website description, and internationalization strategy, to ensure consistency across content and SEO efforts. This agent helps maintain alignment by using stored data to generate relevant, on-brand outputs.","operationId":"_wrapper__organization___project__project_metadata_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__project_metadata_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectMetadataProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/project_metadata/batch_process":{"post":{"tags":["Project Memory"],"summary":"Process a batch of items with the Project Memory agent","description":"Store and retrieve key project metadata, such as tone of voice, website description, and internationalization strategy, to ensure consistency across content and SEO efforts. This agent helps maintain alignment by using stored data to generate relevant, on-brand outputs.","operationId":"_wrapper__organization___project__project_metadata_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__project_metadata_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ProjectMetadataProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Project Metadata Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/screenshot/process":{"post":{"tags":["Screenshot"],"summary":"Process a single item with the Screenshot agent ","description":"Take a screenshot of a webpage.\n \n The agent can optionally focus on a specific element using a CSS selector.\n \n Features:\n - Full page screenshots\n - Optional CSS selector to highlight specific elements\n - Animated GIF generation (zoom into elements or scroll through page)\n - Returns a publicly accessible URL\n \n Animation Feature:\n When animate=true:\n - With a CSS selector: generates an animated GIF that:\n 1. Starts with a full page view from the top\n 2. Zooms into the first element (1-3 slides based on element size/depth)\n 3. Loops over up to 3 additional elements with smooth zoom animations\n - Without a CSS selector: generates an animated GIF that scrolls from top to bottom of the page","operationId":"_wrapper__organization___project__screenshot_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__screenshot_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenshotProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/screenshot/batch_process":{"post":{"tags":["Screenshot"],"summary":"Process a batch of items with the Screenshot agent","description":"Take a screenshot of a webpage.\n \n The agent can optionally focus on a specific element using a CSS selector.\n \n Features:\n - Full page screenshots\n - Optional CSS selector to highlight specific elements\n - Animated GIF generation (zoom into elements or scroll through page)\n - Returns a publicly accessible URL\n \n Animation Feature:\n When animate=true:\n - With a CSS selector: generates an animated GIF that:\n 1. Starts with a full page view from the top\n 2. Zooms into the first element (1-3 slides based on element size/depth)\n 3. Loops over up to 3 additional elements with smooth zoom animations\n - Without a CSS selector: generates an animated GIF that scrolls from top to bottom of the page","operationId":"_wrapper__organization___project__screenshot_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__screenshot_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ScreenshotProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Screenshot Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/searchgpt/process":{"post":{"tags":["SearchGPT"],"summary":"Process a single item with the SearchGPT agent ","description":"Use GPT with web browsing capabilities to search the internet and provide accurate, up-to-date answers to your questions. Perfect for research, fact-checking, and getting comprehensive information about any topic.","operationId":"_wrapper__organization___project__searchgpt_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__searchgpt_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGptProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/searchgpt/batch_process":{"post":{"tags":["SearchGPT"],"summary":"Process a batch of items with the SearchGPT agent","description":"Use GPT with web browsing capabilities to search the internet and provide accurate, up-to-date answers to your questions. Perfect for research, fact-checking, and getting comprehensive information about any topic.","operationId":"_wrapper__organization___project__searchgpt_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__searchgpt_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/SearchGptProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Searchgpt Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/share_of_voice_analysis/process":{"post":{"tags":["Share Of Voice Analysis"],"summary":"Process a single item with the Share Of Voice Analysis agent ","description":"Analyze the share of voice with per-brand sentiment and addressed topics","operationId":"_wrapper__organization___project__share_of_voice_analysis_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__share_of_voice_analysis_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareOfVoiceAnalysisProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/share_of_voice_analysis/batch_process":{"post":{"tags":["Share Of Voice Analysis"],"summary":"Process a batch of items with the Share Of Voice Analysis agent","description":"Analyze the share of voice with per-brand sentiment and addressed topics","operationId":"_wrapper__organization___project__share_of_voice_analysis_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__share_of_voice_analysis_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ShareOfVoiceAnalysisProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Share Of Voice Analysis Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/site_crawler_url_details/process":{"post":{"tags":["URL Details from Botify SiteCrawler"],"summary":"Process a single item with the URL Details from Botify SiteCrawler agent ","description":"Get comprehensive URL analysis from Botify's latest crawl, including:\n\n* Core metadata: title, meta description, H1s, H2s\n\n* Technical details: HTTP status code, response time, content type\n\n* Link relationships: canonical URLs, hreflang tags\n\n* Link graph analysis: internal links, external links, incoming links\n\n* Page content: structured data, main content analysis\n\n* JavaScript rendering: rendered vs HTML content, JS dependencies\n\n* Crawl data: crawl date, crawl depth, crawl path","operationId":"_wrapper__organization___project__site_crawler_url_details_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__site_crawler_url_details_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteCrawlerURLDetailsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/site_crawler_url_details/batch_process":{"post":{"tags":["URL Details from Botify SiteCrawler"],"summary":"Process a batch of items with the URL Details from Botify SiteCrawler agent","description":"Get comprehensive URL analysis from Botify's latest crawl, including:\n\n* Core metadata: title, meta description, H1s, H2s\n\n* Technical details: HTTP status code, response time, content type\n\n* Link relationships: canonical URLs, hreflang tags\n\n* Link graph analysis: internal links, external links, incoming links\n\n* Page content: structured data, main content analysis\n\n* JavaScript rendering: rendered vs HTML content, JS dependencies\n\n* Crawl data: crawl date, crawl depth, crawl path","operationId":"_wrapper__organization___project__site_crawler_url_details_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__site_crawler_url_details_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/SiteCrawlerURLDetailsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Site Crawler Url Details Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_insert/process":{"post":{"tags":["Tables Insert"],"summary":"Process a single item with the Tables Insert agent ","description":"Insert rows into a table in the project's editable catalog.\n Only tables created manually by project members can be modified.\n The table name is specified in the config, and each item contains a single row.\n Use batch mode to insert multiple rows efficiently.","operationId":"_wrapper__organization___project__tables_insert_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_insert_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TablesInsertProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_insert/batch_process":{"post":{"tags":["Tables Insert"],"summary":"Process a batch of items with the Tables Insert agent","description":"Insert rows into a table in the project's editable catalog.\n Only tables created manually by project members can be modified.\n The table name is specified in the config, and each item contains a single row.\n Use batch mode to insert multiple rows efficiently.","operationId":"_wrapper__organization___project__tables_insert_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_insert_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TablesInsertProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Tables Insert Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_load/process":{"post":{"tags":["Tables Load"],"summary":"Process a single item with the Tables Load agent ","description":"Load a CSV or TSV file into the project's editable BigQuery catalog.\n\n The file can be provided by a public HTTP(S) URL or Base64 content.\n For a local file, upload it at https://app.botify.com/:organization/:project/o/storage/tmp and pass the returned URL as source_url.\n \n CSV/TSV files may be gzip compressed.\n The operation fails when the destination table exists unless replace_existing is explicitly enabled.","operationId":"_wrapper__organization___project__tables_load_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_load_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TablesLoadProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_load/batch_process":{"post":{"tags":["Tables Load"],"summary":"Process a batch of items with the Tables Load agent","description":"Load a CSV or TSV file into the project's editable BigQuery catalog.\n\n The file can be provided by a public HTTP(S) URL or Base64 content.\n For a local file, upload it at https://app.botify.com/:organization/:project/o/storage/tmp and pass the returned URL as source_url.\n \n CSV/TSV files may be gzip compressed.\n The operation fails when the destination table exists unless replace_existing is explicitly enabled.","operationId":"_wrapper__organization___project__tables_load_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_load_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TablesLoadProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Tables Load Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_query/process":{"post":{"tags":["Tables Query"],"summary":"Process a single item with the Tables Query agent ","description":"Query any data-model table with\n BigQuery Standard SQL syntax. Always prefix tables with \"catalog.\" (for example,\n catalog.crawl_pages_20251201).\n\n The following query-string functions are supported:\n - query_string_keys(input): returns ARRAY with query-string keys.\n - query_string_params(input): returns\n ARRAY> with query-string key/value pairs.\n - remove_query_string(url, keys): removes URL query-string parameters whose keys\n are in an ARRAY. It removes the \"?\" when no parameter remains.\n\n The parsing functions accept a raw query string with or without a leading \"?\",\n or a complete URL. They preserve parameter order and duplicate keys, ignore\n empty keys, and do not URL-decode values. remove_query_string accepts a complete URL.\n For example:\n SELECT query_string_params(url) FROM catalog.crawl_pages_20251201\n SELECT remove_query_string(url, ['bar']) FROM catalog.crawl_pages_20251201","operationId":"_wrapper__organization___project__tables_query_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_query_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TablesQueryProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_query/batch_process":{"post":{"tags":["Tables Query"],"summary":"Process a batch of items with the Tables Query agent","description":"Query any data-model table with\n BigQuery Standard SQL syntax. Always prefix tables with \"catalog.\" (for example,\n catalog.crawl_pages_20251201).\n\n The following query-string functions are supported:\n - query_string_keys(input): returns ARRAY with query-string keys.\n - query_string_params(input): returns\n ARRAY> with query-string key/value pairs.\n - remove_query_string(url, keys): removes URL query-string parameters whose keys\n are in an ARRAY. It removes the \"?\" when no parameter remains.\n\n The parsing functions accept a raw query string with or without a leading \"?\",\n or a complete URL. They preserve parameter order and duplicate keys, ignore\n empty keys, and do not URL-decode values. remove_query_string accepts a complete URL.\n For example:\n SELECT query_string_params(url) FROM catalog.crawl_pages_20251201\n SELECT remove_query_string(url, ['bar']) FROM catalog.crawl_pages_20251201","operationId":"_wrapper__organization___project__tables_query_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_query_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TablesQueryProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Tables Query Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_schema/process":{"post":{"tags":["Tables Schema"],"summary":"Process a single item with the Tables Schema agent ","description":"List all fields from a given table, including enum values when known.","operationId":"_wrapper__organization___project__tables_schema_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_schema_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TablesSchemaProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_schema/batch_process":{"post":{"tags":["Tables Schema"],"summary":"Process a batch of items with the Tables Schema agent","description":"List all fields from a given table, including enum values when known.","operationId":"_wrapper__organization___project__tables_schema_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_schema_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TablesSchemaProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Tables Schema Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_text_to_sql/process":{"post":{"tags":["Tables Text To Sql"],"summary":"Process a single item with the Tables Text To Sql agent ","description":"This agent converts natural language descriptions into BigQuery SQL query.\n\n You can optionally execute the generated query and get results directly.","operationId":"_wrapper__organization___project__tables_text_to_sql_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_text_to_sql_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TablesTextToSqlProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/tables_text_to_sql/batch_process":{"post":{"tags":["Tables Text To Sql"],"summary":"Process a batch of items with the Tables Text To Sql agent","description":"This agent converts natural language descriptions into BigQuery SQL query.\n\n You can optionally execute the generated query and get results directly.","operationId":"_wrapper__organization___project__tables_text_to_sql_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__tables_text_to_sql_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TablesTextToSqlProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Tables Text To Sql Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/template_generator/process":{"post":{"tags":["Template Generator"],"summary":"Process a single item with the Template Generator agent ","description":"Generate a template based on HTML structure and available variables.","operationId":"_wrapper__organization___project__template_generator_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__template_generator_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateGeneratorProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/template_generator/batch_process":{"post":{"tags":["Template Generator"],"summary":"Process a batch of items with the Template Generator agent","description":"Generate a template based on HTML structure and available variables.","operationId":"_wrapper__organization___project__template_generator_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__template_generator_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TemplateGeneratorProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Template Generator Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/url_keywords/process":{"post":{"tags":["Keywords performance for URL (From Google Search Console)"],"summary":"Process a single item with the Keywords performance for URL (From Google Search Console) agent ","description":"Get Google Search Console keyword performance metrics for a specific URL (i.e., clicks, impressions, position).","operationId":"_wrapper__organization___project__url_keywords_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","title":"If set, activate 'llm/assist mode' with less fields and canvas support","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__url_keywords_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/URLKeywordsProcessedItem"}}}},"400":{"description":"Other client error (issue in the payload, authentication...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Other processing errors (including server issues)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/url_keywords/batch_process":{"post":{"tags":["Keywords performance for URL (From Google Search Console)"],"summary":"Process a batch of items with the Keywords performance for URL (From Google Search Console) agent","description":"Get Google Search Console keyword performance metrics for a specific URL (i.e., clicks, impressions, position).","operationId":"_wrapper__organization___project__url_keywords_batch_process_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9\\._-]+$","title":"Botify Organization"}},{"name":"project","in":"path","required":true,"schema":{"type":"string","pattern":"[a-zA-Z0-9_-]+$","title":"Botify Project"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body__wrapper__organization___project__url_keywords_batch_process_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/URLKeywordsProcessedItem"},{"$ref":"#/components/schemas/Error"}]},"title":"Response Wrapper Organization Project Url Keywords Batch Process Post"}}}},"400":{"description":"There is a global client error or ALL items failed to process with a client error (bad auth...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The batch request is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catastrophic processing errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/__health":{"get":{"tags":["management"],"summary":"Health","operationId":"health___health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/agents":{"get":{"tags":["management"],"summary":"List Agents","operationId":"list_agents_agents_get","parameters":[{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","description":"If True, only agents available in llm/chat are returned","default":false,"title":"Llm"},"description":"If True, only agents available in llm/chat are returned"},{"name":"deepthink","in":"query","required":false,"schema":{"type":"boolean","description":"If True, only agents available in llm/chat with reasoning are returned","default":false,"title":"Deepthink"},"description":"If True, only agents available in llm/chat with reasoning are returned"},{"name":"mcp","in":"query","required":false,"schema":{"type":"boolean","description":"If True, only agents available on MCP are returned","default":false,"title":"Mcp"},"description":"If True, only agents available on MCP are returned"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Agents Agents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agents/{identifier}":{"get":{"tags":["management"],"summary":"Get Agent","operationId":"get_agent_agents__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"llm","in":"query","required":false,"schema":{"type":"boolean","description":"If True, only agents available in llm/chat are returned","default":false,"title":"Llm"},"description":"If True, only agents available in llm/chat are returned"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Agent Agents Identifier Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/processing_output/{output_id}":{"get":{"summary":"Get Processing Output","operationId":"get_processing_output_processing_output__output_id__get","parameters":[{"name":"output_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$","description":"The output ID","title":"Output Id"},"description":"The output ID"},{"name":"since_timestamp_us","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp in microseconds to filter messages since","title":"Since Timestamp Us"},"description":"The timestamp in microseconds to filter messages since"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Message"},"title":"Response Get Processing Output Processing Output Output Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/{organization}/{project}/workflow_runner/run/{run_id}":{"get":{"tags":["Workflow Runner"],"summary":"Get Workflow Run Status","description":"Get the status of a workflow run by its ID.","operationId":"get_workflow_run_status__organization___project__workflow_runner_run__run_id__get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","description":"The workflow run ID","title":"Run Id"},"description":"The workflow run ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/workflow_runner/run/{run_id}/cancel":{"post":{"tags":["Workflow Runner"],"summary":"Cancel Workflow Run Endpoint","description":"Cancel a workflow run using a Cloud Run execution name.","operationId":"cancel_workflow_run_endpoint__organization___project__workflow_runner_run__run_id__cancel_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","description":"The workflow run ID","title":"Run Id"},"description":"The workflow run ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowRunCancelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowRunCancelResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/workflow_runner/run/{run_id}/summary":{"get":{"tags":["Workflow Runner"],"summary":"Get Workflow Run Status Summary","description":"Get a lightweight status of a workflow run (counters + last task per node only).","operationId":"get_workflow_run_status_summary__organization___project__workflow_runner_run__run_id__summary_get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","description":"The workflow run ID","title":"Run Id"},"description":"The workflow run ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStatusSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/workflow_runner/run/{run_id}/node/{node_id}/task/{task_index}":{"get":{"tags":["Workflow Runner"],"summary":"Get Workflow Run Node Task Detail","description":"Get the detail of a specific task for a given node in a workflow run.","operationId":"get_workflow_run_node_task_detail__organization___project__workflow_runner_run__run_id__node__node_id__task__task_index__get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","description":"The workflow run ID","title":"Run Id"},"description":"The workflow run ID"},{"name":"node_id","in":"path","required":true,"schema":{"type":"string","description":"The node ID within the workflow","title":"Node Id"},"description":"The node ID within the workflow"},{"name":"task_index","in":"path","required":true,"schema":{"type":"integer","minimum":0,"description":"The task index within the node (0-based)","title":"Task Index"},"description":"The task index within the node (0-based)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeTaskDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/batch_jobs/{job_id}":{"get":{"tags":["Batch Run"],"summary":"Get Batch Job Status","description":"Get the progress of a batch_run job.","operationId":"get_batch_job_status__organization___project__batch_jobs__job_id__get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"The batch job ID","title":"Job Id"},"description":"The batch job ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/batch_jobs/{job_id}/sample":{"get":{"tags":["Batch Run"],"summary":"Get Batch Job Sample","description":"Read the first records a batch job wrote, to check them before using them.","operationId":"get_batch_job_sample__organization___project__batch_jobs__job_id__sample_get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"The batch job ID","title":"Job Id"},"description":"The batch job ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"How many records to return.","default":5,"title":"Limit"},"description":"How many records to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Batch Job Sample Organization Project Batch Jobs Job Id Sample Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/batch_jobs/{job_id}/cancel":{"post":{"tags":["Batch Run"],"summary":"Cancel Batch Job","description":"Stop a batch job at its next chunk boundary, keeping what it produced.","operationId":"cancel_batch_job__organization___project__batch_jobs__job_id__cancel_post","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"The batch job ID","title":"Job Id"},"description":"The batch job ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{organization}/{project}/storage/tmp":{"post":{"summary":"Tmp Storage Upload","operationId":"tmp_upload","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TmpUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/{organization}/{project}/storage/tmp/{upload_id}":{"get":{"summary":"Tmp Storage Download","operationId":"tmp_storage_download__organization___project__storage_tmp__upload_id__get","parameters":[{"name":"organization","in":"path","required":true,"schema":{"type":"string","description":"The organization name","title":"Organization"},"description":"The organization name"},{"name":"project","in":"path","required":true,"schema":{"type":"string","description":"The project name","title":"Project"},"description":"The project name"},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}}},"components":{"schemas":{"ActionBoardCanvas":{"properties":{"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"config":{"additionalProperties":true,"type":"object","title":"Config"}},"type":"object","required":["title","description","config"],"title":"ActionBoardCanvas"},"ActionBoardProcessedItem":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ActionBoardResult"},"type":"array","title":"Results","description":"Action board results"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["results","status"],"title":"ActionBoardProcessedItem"},"ActionBoardResult":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"relevance":{"anyOf":[{"type":"string","enum":["LOW","MIDDLE","HIGH"]},{"type":"null"}],"title":"Relevance"},"impact_metrics":{"$ref":"#/components/schemas/ImpactedMetric"},"canvas":{"items":{"$ref":"#/components/schemas/ActionBoardCanvas"},"type":"array","title":"Canvas"}},"type":"object","required":["name","description","relevance","impact_metrics","canvas"],"title":"ActionBoardResult"},"AddressedTopic":{"properties":{"topic":{"type":"string","title":"Topic","description":"Topic addressed (1-3 words, e.g. 'pricing', 'reliability')"},"sentiment":{"type":"string","enum":["positive","negative","neutral"],"title":"Sentiment","description":"Sentiment for this topic about this brand (positive, negative, or neutral)"}},"type":"object","required":["topic","sentiment"],"title":"AddressedTopic","description":"A topic addressed about a brand with its sentiment."},"AgenticCatalogDestination":{"properties":{"type":{"type":"string","title":"Type","description":"Destination type. Filter `destination` on this value in `agentic_catalog_destinations_push`. `dummy` is a no-op and never appears in that table."},"name":{"type":"string","title":"Name","description":"Human-readable destination name."},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Destination settings (credentials are masked)."}},"type":"object","required":["type","name","config"],"title":"AgenticCatalogDestination","description":"One destination configured on an AgenticCatalog source."},"AgenticCatalogSource":{"properties":{"id":{"type":"string","title":"Id","description":"Source identifier. Filter `source_id` on this value in the AgenticCatalog BigQuery tables."},"name":{"type":"string","title":"Name","description":"Human-readable source name."},"description":{"type":"string","title":"Description","description":"Optional source description."},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Source-level settings (datasource, enrichment, language, ...). Secrets are masked."},"destinations":{"items":{"$ref":"#/components/schemas/AgenticCatalogDestination"},"type":"array","title":"Destinations","description":"Destinations this source is configured to push to."}},"type":"object","required":["id","name","description","config","destinations"],"title":"AgenticCatalogSource","description":"One AgenticCatalog source configured on the project."},"AgenticCatalogSourcesConfig":{"properties":{},"type":"object","title":"AgenticCatalogSourcesConfig"},"AgenticCatalogSourcesItem":{"properties":{},"type":"object","title":"AgenticCatalogSourcesItem"},"AgenticCatalogSourcesProcessedItem":{"properties":{"sources":{"items":{"$ref":"#/components/schemas/AgenticCatalogSource"},"type":"array","title":"Sources","description":"Every source configured on the project, pulled or not. `id` is what to filter `source_id` on in the AgenticCatalog BigQuery tables; `destinations[].type` is what to filter `destination` on. Empty means the project has no AgenticCatalog."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["sources","status"],"title":"AgenticCatalogSourcesProcessedItem"},"ArrayItemMatch":{"properties":{"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"Sub-object fields to match (subset, no exhaustivity required)"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Free-form note describing how to locate this item in the page. Never used by the evaluator — purely informational."}},"type":"object","title":"ArrayItemMatch","description":"A sub-object pattern that at least one array item must match.\n\nThe mapping ``fields`` is keyed by the sub-object's attribute names\n(e.g. ``{\"review_text\": \"great\", \"review_rating\": 5}``). Keys not\nlisted here are not checked.\n\nFor convenience, a bare sub-object is accepted as a shorthand for\n``fields``: ``{\"name\": \"Année\", \"value\": \"1982\"}`` is normalised to\n``{\"fields\": {\"name\": \"Année\", \"value\": \"1982\"}}``. To match an array of\n*scalars* (e.g. a list of URLs), pass the scalar directly in\n``expected_array_items`` rather than an :class:`ArrayItemMatch`."},"BQLConfig":{"properties":{"run_query":{"type":"boolean","title":"Run Query","description":"Whether to run the query","default":true}},"type":"object","title":"BQLConfig"},"BQLItem":{"properties":{"query":{"type":"string","title":"Query","description":"Human readable query to get data from (ex: indexable URLs by depth, avg outlinks by pagetype, impressions by country last month, etc)"}},"type":"object","required":["query"],"title":"BQLItem"},"BQLMetadata":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/BQLResultField"},"type":"array","title":"Fields"},"is_bql_v2":{"type":"boolean","title":"Is Bql V2","default":true}},"type":"object","required":["fields"],"title":"BQLMetadata"},"BQLProcessedItem":{"properties":{"bql_query":{"additionalProperties":true,"type":"object","title":"Bql Query","description":"Generated BQL query"},"results":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Results","description":"Results of the BQL query"},"metadata":{"$ref":"#/components/schemas/BQLMetadata","description":"Metadata of the BQL query"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Query requested by the user"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["bql_query","results","metadata","status"],"title":"BQLProcessedItem"},"BQLResultField":{"properties":{"kind":{"type":"string","enum":["dimension","metric"],"title":"Kind"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtype"},"metadata":{"$ref":"#/components/schemas/FieldMetadata"},"multiple":{"type":"boolean","title":"Multiple"}},"type":"object","required":["kind","name","type","metadata","multiple"],"title":"BQLResultField"},"BatchRunConfig":{"properties":{"on_error":{"$ref":"#/components/schemas/OnError","description":"skip: record the failure and carry on. fail_job: stop the whole batch on the first failing record.","default":"skip"},"chunk_size":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Chunk Size","description":"Records sent to the tool at once.","default":50},"inline_max_rows":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Inline Max Rows","description":"Above this many records, the batch runs as a job.","default":10}},"type":"object","title":"BatchRunConfig"},"BatchRunItem":{"properties":{"tool":{"type":"string","title":"Tool","description":"Id of the tool to run over every record. Use tool_documentation to read its item schema before writing item_map."},"source":{"$ref":"#/components/schemas/SourceSpec","description":"Where the records come from."},"item_map":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Item Map","description":"Projection from a source record onto the tool's item, using {{row.}} (ex: {\"url\": \"{{row.page_url}}\"}). Omit it when the records already have the tool's item shape."},"sink":{"anyOf":[{"$ref":"#/components/schemas/SinkSpec"},{"type":"null"}],"description":"Where results go. Defaults to a temporary gzipped JSONL file whose URL can be passed straight back as a file source."},"tool_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Config","description":"The target tool's own config, shared by every record."},"dry_run":{"type":"boolean","title":"Dry Run","description":"Run only the first 5 records and return them in full, launching nothing. Use it to check a mapping or a prompt against a large source in one turn.","default":false}},"type":"object","required":["tool","source"],"title":"BatchRunItem","description":"One batch: a tool, where its records come from, and where they go."},"BatchRunResult":{"properties":{"mode":{"type":"string","enum":["dry_run","inline","job"],"title":"Mode","description":"dry_run and inline carry their results; job carries a job_id to poll with batch_status."},"tool":{"type":"string","title":"Tool","description":"The tool that was run."},"results":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Results","description":"One {item, response, error} object per record."},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"Poll it with batch_status."},"execution_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Id","description":"Underlying Cloud Run execution."},"rows_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Total","description":"Records the batch will process."},"rows_ok":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Ok","description":"Records that succeeded."},"rows_error":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Error","description":"Records that failed."},"estimated_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Credits","description":"Credits the batch is expected to cost."},"sink":{"anyOf":[{"$ref":"#/components/schemas/SinkPointer"},{"type":"null"}],"description":"Where the output landed."},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"One line about the outcome."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["mode","tool","status"],"title":"BatchRunResult","description":"What a batch returns, whichever path it took."},"Body__wrapper__organization___project__action_board_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/Item"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__action_board_batch_process_post"},"Body__wrapper__organization___project__action_board_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/Item"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__action_board_process_post"},"Body__wrapper__organization___project__agentic_catalog_sources_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/AgenticCatalogSourcesConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/AgenticCatalogSourcesItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__agentic_catalog_sources_batch_process_post"},"Body__wrapper__organization___project__agentic_catalog_sources_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/AgenticCatalogSourcesConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/AgenticCatalogSourcesItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__agentic_catalog_sources_process_post"},"Body__wrapper__organization___project__ai_gateway_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/LLMWrapperConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/LLMWrapperItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__ai_gateway_batch_process_post"},"Body__wrapper__organization___project__ai_gateway_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/LLMWrapperConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/LLMWrapperItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__ai_gateway_process_post"},"Body__wrapper__organization___project__batch_run_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BatchRunConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/BatchRunItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__batch_run_batch_process_post"},"Body__wrapper__organization___project__batch_run_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BatchRunConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/BatchRunItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__batch_run_process_post"},"Body__wrapper__organization___project__botify_config_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfigConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/BotifyConfigItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__botify_config_batch_process_post"},"Body__wrapper__organization___project__botify_config_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfigConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/BotifyConfigItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__botify_config_process_post"},"Body__wrapper__organization___project__botify_data_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BQLConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/BQLItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__botify_data_batch_process_post"},"Body__wrapper__organization___project__botify_data_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BQLConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/BQLItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__botify_data_process_post"},"Body__wrapper__organization___project__calculator_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/CalculatorConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/CalculatorItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__calculator_batch_process_post"},"Body__wrapper__organization___project__calculator_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/CalculatorConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/CalculatorItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__calculator_process_post"},"Body__wrapper__organization___project__chatgpt_websearch_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ChatGPTWebSearchConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/ChatGPTWebSearchItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__chatgpt_websearch_batch_process_post"},"Body__wrapper__organization___project__chatgpt_websearch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ChatGPTWebSearchConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/ChatGPTWebSearchItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__chatgpt_websearch_process_post"},"Body__wrapper__organization___project__embed_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/EmbedConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/EmbedItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__embed_batch_process_post"},"Body__wrapper__organization___project__embed_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/EmbedConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/EmbedItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__embed_process_post"},"Body__wrapper__organization___project__get_credit_usage_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/Item"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__get_credit_usage_batch_process_post"},"Body__wrapper__organization___project__get_credit_usage_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/Item"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__get_credit_usage_process_post"},"Body__wrapper__organization___project__google_ads_keyword_suggestions_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_ads_keyword_suggestions_batch_process_post"},"Body__wrapper__organization___project__google_ads_keyword_suggestions_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleAdsKeywordSuggestionsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_ads_keyword_suggestions_process_post"},"Body__wrapper__organization___project__google_ads_search_volume_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/DataForSeoConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleAdsSearchVolumeItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_ads_search_volume_batch_process_post"},"Body__wrapper__organization___project__google_ads_search_volume_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/DataForSeoConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleAdsSearchVolumeItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_ads_search_volume_process_post"},"Body__wrapper__organization___project__google_ai_mode_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiModeConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleAiModeItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_ai_mode_batch_process_post"},"Body__wrapper__organization___project__google_ai_mode_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiModeConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleAiModeItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_ai_mode_process_post"},"Body__wrapper__organization___project__google_ai_overview_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiOverviewConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleAiOverviewItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_ai_overview_batch_process_post"},"Body__wrapper__organization___project__google_ai_overview_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiOverviewConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleAiOverviewItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_ai_overview_process_post"},"Body__wrapper__organization___project__google_gemini_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleGeminiConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleGeminiItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_gemini_batch_process_post"},"Body__wrapper__organization___project__google_gemini_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleGeminiConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleGeminiItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_gemini_process_post"},"Body__wrapper__organization___project__google_knowledge_graph_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleKnowledgeGraphConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleKnowledgeGraphItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_knowledge_graph_batch_process_post"},"Body__wrapper__organization___project__google_knowledge_graph_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleKnowledgeGraphConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleKnowledgeGraphItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_knowledge_graph_process_post"},"Body__wrapper__organization___project__google_people_also_ask_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoAskConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GooglePeopleAlsoAskItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_people_also_ask_batch_process_post"},"Body__wrapper__organization___project__google_people_also_ask_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoAskConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GooglePeopleAlsoAskItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_people_also_ask_process_post"},"Body__wrapper__organization___project__google_people_also_search_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoSearchConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GooglePeopleAlsoSearchItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_people_also_search_batch_process_post"},"Body__wrapper__organization___project__google_people_also_search_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePeopleAlsoSearchConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GooglePeopleAlsoSearchItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_people_also_search_process_post"},"Body__wrapper__organization___project__google_position_opportunities_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePositionOpportunitiesConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GooglePositionOpportunitiesItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_position_opportunities_batch_process_post"},"Body__wrapper__organization___project__google_position_opportunities_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GooglePositionOpportunitiesConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GooglePositionOpportunitiesItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_position_opportunities_process_post"},"Body__wrapper__organization___project__google_search_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleSearchItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_search_batch_process_post"},"Body__wrapper__organization___project__google_search_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleSearchItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_search_process_post"},"Body__wrapper__organization___project__google_serp_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchRawConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleSearchRawItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_serp_batch_process_post"},"Body__wrapper__organization___project__google_serp_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleSearchRawConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleSearchRawItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_serp_process_post"},"Body__wrapper__organization___project__google_trends_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleTrendsConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleTrendsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_trends_batch_process_post"},"Body__wrapper__organization___project__google_trends_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleTrendsConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleTrendsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_trends_process_post"},"Body__wrapper__organization___project__google_url_inspection_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleURLInspectionConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/GoogleURLInspectionItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__google_url_inspection_batch_process_post"},"Body__wrapper__organization___project__google_url_inspection_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/GoogleURLInspectionConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/GoogleURLInspectionItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__google_url_inspection_process_post"},"Body__wrapper__organization___project__html_code_executor_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLExecutorConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HTMLExecutorItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_code_executor_batch_process_post"},"Body__wrapper__organization___project__html_code_executor_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLExecutorConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HTMLExecutorItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_code_executor_process_post"},"Body__wrapper__organization___project__html_extract_images_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLExtractImagesConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HTMLExtractImagesItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_extract_images_batch_process_post"},"Body__wrapper__organization___project__html_extract_images_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLExtractImagesConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HTMLExtractImagesItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_extract_images_process_post"},"Body__wrapper__organization___project__html_extractor_css_selector_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlExtractorCssSelectorConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HtmlExtractorCssSelectorItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_extractor_css_selector_batch_process_post"},"Body__wrapper__organization___project__html_extractor_css_selector_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlExtractorCssSelectorConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HtmlExtractorCssSelectorItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_extractor_css_selector_process_post"},"Body__wrapper__organization___project__html_fetch_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLFetchConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HTMLFetchItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_fetch_batch_process_post"},"Body__wrapper__organization___project__html_fetch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLFetchConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HTMLFetchItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_fetch_process_post"},"Body__wrapper__organization___project__html_grep_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlGrepConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HtmlGrepItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_grep_batch_process_post"},"Body__wrapper__organization___project__html_grep_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlGrepConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HtmlGrepItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_grep_process_post"},"Body__wrapper__organization___project__html_lang_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlLangConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HtmlLangItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_lang_batch_process_post"},"Body__wrapper__organization___project__html_lang_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlLangConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HtmlLangItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_lang_process_post"},"Body__wrapper__organization___project__html_pageworkers_preview_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlPageWorkersPreviewConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HtmlPageWorkersPreviewItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_pageworkers_preview_batch_process_post"},"Body__wrapper__organization___project__html_pageworkers_preview_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlPageWorkersPreviewConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HtmlPageWorkersPreviewItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_pageworkers_preview_process_post"},"Body__wrapper__organization___project__html_question_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLQuestionConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HTMLQuestionItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_question_batch_process_post"},"Body__wrapper__organization___project__html_question_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLQuestionConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HTMLQuestionItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_question_process_post"},"Body__wrapper__organization___project__html_structured_data_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLStructuredDataConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HTMLStructuredDataItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_structured_data_batch_process_post"},"Body__wrapper__organization___project__html_structured_data_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HTMLStructuredDataConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HTMLStructuredDataItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_structured_data_process_post"},"Body__wrapper__organization___project__html_to_text_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlToTextConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/HtmlToTextItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__html_to_text_batch_process_post"},"Body__wrapper__organization___project__html_to_text_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/HtmlToTextConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/HtmlToTextItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__html_to_text_process_post"},"Body__wrapper__organization___project__keywords_clustering_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsClusteringConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/KeywordsClusteringItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__keywords_clustering_batch_process_post"},"Body__wrapper__organization___project__keywords_clustering_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsClusteringConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/KeywordsClusteringItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__keywords_clustering_process_post"},"Body__wrapper__organization___project__keywords_extractor_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsExtractorConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/KeywordsExtractorItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__keywords_extractor_batch_process_post"},"Body__wrapper__organization___project__keywords_extractor_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsExtractorConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/KeywordsExtractorItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__keywords_extractor_process_post"},"Body__wrapper__organization___project__keywords_suggestions_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/KeywordsSuggestionsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__keywords_suggestions_batch_process_post"},"Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_batch_process_post"},"Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/KeywordsSuggestionsGoogleAdsPlannerItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__keywords_suggestions_google_ads_planner_process_post"},"Body__wrapper__organization___project__keywords_suggestions_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KeywordsSuggestionsConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/KeywordsSuggestionsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__keywords_suggestions_process_post"},"Body__wrapper__organization___project__knowledge_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KnowledgeAgentConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/KnowledgeAgentItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__knowledge_batch_process_post"},"Body__wrapper__organization___project__knowledge_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/KnowledgeAgentConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/KnowledgeAgentItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__knowledge_process_post"},"Body__wrapper__organization___project__list_annotations_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/ListAnnotationsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__list_annotations_batch_process_post"},"Body__wrapper__organization___project__list_annotations_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/ListAnnotationsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__list_annotations_process_post"},"Body__wrapper__organization___project__nearest_page_for_topic_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/NearestPageForTopicConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/NearestPageForTopicItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__nearest_page_for_topic_batch_process_post"},"Body__wrapper__organization___project__nearest_page_for_topic_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/NearestPageForTopicConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/NearestPageForTopicItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__nearest_page_for_topic_process_post"},"Body__wrapper__organization___project__organic_keyword_suggestions_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/OrganicKeywordSuggestionsConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/OrganicKeywordSuggestionsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__organic_keyword_suggestions_batch_process_post"},"Body__wrapper__organization___project__organic_keyword_suggestions_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/OrganicKeywordSuggestionsConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/OrganicKeywordSuggestionsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__organic_keyword_suggestions_process_post"},"Body__wrapper__organization___project__pageworkers_generic_urls_actions_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/PageWorkersConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/PageWorkersItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__pageworkers_generic_urls_actions_batch_process_post"},"Body__wrapper__organization___project__pageworkers_generic_urls_actions_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/PageWorkersConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/PageWorkersItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__pageworkers_generic_urls_actions_process_post"},"Body__wrapper__organization___project__perplexity_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__perplexity_batch_process_post"},"Body__wrapper__organization___project__perplexity_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/dinosaur__agents__agents__perplexity__agent__PerplexityItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__perplexity_process_post"},"Body__wrapper__organization___project__project_metadata_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ProjectMetadataConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/ProjectMetadataItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__project_metadata_batch_process_post"},"Body__wrapper__organization___project__project_metadata_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ProjectMetadataConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/ProjectMetadataItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__project_metadata_process_post"},"Body__wrapper__organization___project__screenshot_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ScreenshotConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/ScreenshotItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__screenshot_batch_process_post"},"Body__wrapper__organization___project__screenshot_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ScreenshotConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/ScreenshotItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__screenshot_process_post"},"Body__wrapper__organization___project__searchgpt_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/SearchGptConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/SearchGptItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__searchgpt_batch_process_post"},"Body__wrapper__organization___project__searchgpt_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/SearchGptConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/SearchGptItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__searchgpt_process_post"},"Body__wrapper__organization___project__share_of_voice_analysis_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ShareOfVoiceAnalysisConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/ShareOfVoiceAnalysisItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__share_of_voice_analysis_batch_process_post"},"Body__wrapper__organization___project__share_of_voice_analysis_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/ShareOfVoiceAnalysisConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/ShareOfVoiceAnalysisItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__share_of_voice_analysis_process_post"},"Body__wrapper__organization___project__site_crawler_url_details_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/SiteCrawlerURLDetailsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__site_crawler_url_details_batch_process_post"},"Body__wrapper__organization___project__site_crawler_url_details_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/BotifyConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/SiteCrawlerURLDetailsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__site_crawler_url_details_process_post"},"Body__wrapper__organization___project__tables_insert_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesInsertConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TablesInsertItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__tables_insert_batch_process_post"},"Body__wrapper__organization___project__tables_insert_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesInsertConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TablesInsertItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__tables_insert_process_post"},"Body__wrapper__organization___project__tables_load_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesLoadConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TablesLoadItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__tables_load_batch_process_post"},"Body__wrapper__organization___project__tables_load_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesLoadConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TablesLoadItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__tables_load_process_post"},"Body__wrapper__organization___project__tables_query_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesQueryConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TablesQueryItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__tables_query_batch_process_post"},"Body__wrapper__organization___project__tables_query_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesQueryConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TablesQueryItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__tables_query_process_post"},"Body__wrapper__organization___project__tables_schema_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesSchemaConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TablesSchemaItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__tables_schema_batch_process_post"},"Body__wrapper__organization___project__tables_schema_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesSchemaConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TablesSchemaItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__tables_schema_process_post"},"Body__wrapper__organization___project__tables_text_to_sql_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesTextToSqlConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TablesTextToSqlItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__tables_text_to_sql_batch_process_post"},"Body__wrapper__organization___project__tables_text_to_sql_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TablesTextToSqlConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TablesTextToSqlItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__tables_text_to_sql_process_post"},"Body__wrapper__organization___project__template_generator_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TemplateGeneratorConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/TemplateGeneratorItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__template_generator_batch_process_post"},"Body__wrapper__organization___project__template_generator_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/TemplateGeneratorConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/TemplateGeneratorItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__template_generator_process_post"},"Body__wrapper__organization___project__url_keywords_batch_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/URLKeywordsConfig"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/URLKeywordsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"Body__wrapper__organization___project__url_keywords_batch_process_post"},"Body__wrapper__organization___project__url_keywords_process_post":{"properties":{"config":{"anyOf":[{"$ref":"#/components/schemas/URLKeywordsConfig"},{"type":"null"}]},"item":{"$ref":"#/components/schemas/URLKeywordsItem"}},"type":"object","required":["item"],"title":"Body__wrapper__organization___project__url_keywords_process_post"},"BotifyConfig":{"properties":{},"type":"object","title":"BotifyConfig"},"BotifyConfigConfig":{"properties":{},"type":"object","title":"BotifyConfigConfig"},"BotifyConfigItem":{"properties":{"products":{"items":{"type":"string","enum":["speedworkers","pageworkers","botify_core"]},"type":"array","title":"Products","description":"List of products to get configuration for. Can be 'speedworkers', 'pageworkers', 'botify_core', or any combination."}},"type":"object","required":["products"],"title":"BotifyConfigItem"},"BotifyConfigProcessedItem":{"properties":{"speedworkers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Speedworkers","description":"SpeedWorkers configuration if requested"},"pageworkers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pageworkers","description":"PageWorkers configuration if requested"},"botify_core":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Botify Core","description":"Botify Core project configuration if requested"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["status"],"title":"BotifyConfigProcessedItem"},"BrandMention":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name","description":"Brand name (lowercase, no duplicates, max 100 characters)"},"rationale":{"type":"string","title":"Rationale","description":"Concise explanation (1 sentence) of where/how the brand appears in the answer.\nExample: \"Recommended as budget option in the comparison section.\"\nExample: \"Listed among alternatives without detailed evaluation.\"\nExample: \"Mentioned as market leader in the introduction.\""},"addressed_topics":{"items":{"$ref":"#/components/schemas/AddressedTopic"},"type":"array","maxItems":3,"title":"Addressed Topics","description":"Topics discussed about THIS BRAND with their sentiment (max 3).\nEach topic should be 1-3 words (e.g. \"pricing\", \"reliability\", \"customer support\").\nExample for Nike: [{\"topic\": \"durability\", \"sentiment\": \"positive\"}, {\"topic\": \"pricing\", \"sentiment\": \"negative\"}, {\"topic\": \"delivery\", \"sentiment\": \"neutral\"}]","default":[]}},"type":"object","required":["name","rationale"],"title":"BrandMention","description":"A brand mentioned in the AI answer with rationale and per-topic sentiments."},"CTRDataPoint":{"properties":{"avg_position":{"type":"integer","title":"Avg Position","description":"Average ranking position"},"device":{"type":"string","title":"Device","description":"Device type"},"nb_urls":{"type":"integer","title":"Nb Urls","description":"Number of URLs"},"pct_urls_with_clicks":{"type":"number","title":"Pct Urls With Clicks","description":"Percentage of URLs with clicks"},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions"},"clicks":{"type":"integer","title":"Clicks","description":"Total clicks"},"ctr_global":{"type":"number","title":"Ctr Global","description":"Global CTR"}},"type":"object","required":["avg_position","device","nb_urls","pct_urls_with_clicks","impressions","clicks","ctr_global"],"title":"CTRDataPoint"},"CalculatorConfig":{"properties":{},"type":"object","title":"CalculatorConfig"},"CalculatorItem":{"properties":{"expression":{"type":"string","title":"Expression","description":"Arithmetic expression to evaluate"}},"type":"object","required":["expression"],"title":"CalculatorItem"},"CalculatorProcessedItem":{"properties":{"result":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Result","description":"Arithmetic expression evaluation result"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["result","status"],"title":"CalculatorProcessedItem"},"ChartAnnotation":{"properties":{"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Annotation start date and time"},"data":{"anyOf":[{"$ref":"#/components/schemas/ChartAnnotationData"},{"type":"null"}],"description":"Annotation payload (typically includes content text)"}},"type":"object","required":["start_date"],"title":"ChartAnnotation","description":"Project chart annotation with only the fields exposed by the agent."},"ChartAnnotationData":{"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"}},"additionalProperties":true,"type":"object","title":"ChartAnnotationData"},"ChatGPTWebSearchConfig":{"properties":{"country":{"type":"string","title":"Country","description":"ISO 3166-1 alpha-2 country code for location-based results (e.g., 'US', 'FR')","default":""}},"type":"object","title":"ChatGPTWebSearchConfig","description":"Unified config for ChatGPT web search agents."},"ChatGPTWebSearchItem":{"properties":{"query":{"type":"string","minLength":1,"title":"Query","description":"The search query to send to ChatGPT"}},"type":"object","required":["query"],"title":"ChatGPTWebSearchItem","description":"Unified input item for ChatGPT web search agents."},"ChatGPTWebSearchProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The search query that was executed"},"answer_text_markdown":{"type":"string","title":"Answer Text Markdown","description":"The markdown response from ChatGPT"},"links":{"items":{"$ref":"#/components/schemas/dinosaur__agents__common__chatgpt_websearch_entities__Link"},"type":"array","title":"Links","description":"Inline citation links from the response"},"citations":{"items":{"$ref":"#/components/schemas/dinosaur__agents__common__chatgpt_websearch_entities__Citation"},"type":"array","title":"Citations","description":"Sources cited in the response"},"shopping":{"items":{"$ref":"#/components/schemas/Shopping"},"type":"array","title":"Shopping","description":"Shopping results if any"},"shopping_visible":{"type":"boolean","title":"Shopping Visible","description":"Whether shopping results are visible"},"web_search_triggered":{"type":"boolean","title":"Web Search Triggered","description":"Whether the answer shows evidence of a web search (citations, search sources, search queries, inline citation links, or shopping items)"},"search_sources":{"items":{"$ref":"#/components/schemas/SearchSource"},"type":"array","title":"Search Sources","description":"Search result sources with snippets"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Name / version of the model used by ChatGPT (e.g., 'gpt-4o')"},"search_queries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Search Queries","description":"Web search queries used during processing"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","answer_text_markdown","links","citations","shopping","shopping_visible","web_search_triggered","search_sources","status"],"title":"ChatGPTWebSearchProcessedItem","description":"Unified output item for ChatGPT web search agents."},"ColumnDefinition":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the column"},"type":{"type":"string","enum":["STRING","BYTES","INTEGER","INT64","FLOAT","FLOAT64","NUMERIC","BIGNUMERIC","BOOLEAN","BOOL","TIMESTAMP","DATE","TIME","DATETIME","GEOGRAPHY","RECORD","STRUCT","JSON"],"title":"Type","description":"BigQuery column type"},"mode":{"type":"string","enum":["NULLABLE","REQUIRED","REPEATED"],"title":"Mode","description":"Column mode","default":"NULLABLE"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional description of the column"},"fields":{"anyOf":[{"items":{"$ref":"#/components/schemas/ColumnDefinition"},"type":"array"},{"type":"null"}],"title":"Fields","description":"Nested fields for RECORD type columns"}},"type":"object","required":["name","type"],"title":"ColumnDefinition","description":"Definition of a column in the table."},"CreditWindow":{"properties":{"usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usage Percent","description":"Share of the window's allowance that has been consumed, above 100 once the allowance is passed. Null when there is no allowance to take a share of -- not a statement that calls are blocked"},"status":{"type":"string","enum":["healthy","warning","over","blocked"],"title":"Status","description":"Where this window's consumption stands, and the only field that says whether calls are still being served: they are refused on ``blocked`` alone"},"resets_at":{"type":"string","format":"date-time","title":"Resets At","description":"When the window rolls over and consumption returns to 0"}},"type":"object","required":["usage_percent","status","resets_at"],"title":"CreditWindow","description":"How far through its allowance one window is, and where that stands."},"CssSelectorPreview":{"properties":{"descriptors":{"anyOf":[{"items":{"$ref":"#/components/schemas/PreviewDescriptor"},"type":"array"},{"type":"null"}],"title":"Descriptors"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"CssSelectorPreview"},"CustomChange":{"properties":{"selector":{"type":"string","title":"Selector","description":"CSS selector of the element to update (ex: \"h1\", \".article-count\", etc)."},"strategy":{"type":"string","enum":["prepend","append","insertAfter","insertBefore","replace","replaceElement"],"title":"Strategy","description":"Update strategy to use"},"value":{"type":"string","title":"Value","description":"Value to update"},"max_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Date","description":"Maximum date to apply the update (YYYY-MM-DD format)"}},"type":"object","required":["selector","strategy","value"],"title":"CustomChange","description":"A custom change to apply to the page."},"DataForSeoConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"DataForSeoConfig"},"DelimitedFormat":{"type":"string","enum":["auto","csv","tsv"]},"DeviceOpportunity":{"properties":{"position":{"type":"integer","title":"Position","description":"Target ranking position"},"additional_clicks":{"type":"number","title":"Additional Clicks","description":"Additional clicks expected at this position"},"target_ctr":{"type":"number","title":"Target Ctr","description":"Expected CTR at target position (as %)"},"current_ctr":{"type":"number","title":"Current Ctr","description":"Current CTR (as %)"}},"type":"object","required":["position","additional_clicks","target_ctr","current_ctr"],"title":"DeviceOpportunity"},"DiscoveryEngineModelScoresResult":{"properties":{"relevance_score":{"items":{"type":"number"},"type":"array","title":"Relevance Score"}},"type":"object","required":["relevance_score"],"title":"DiscoveryEngineModelScoresResult"},"DiscoveryEngineSearchResult":{"properties":{"document":{"anyOf":[{"$ref":"#/components/schemas/DiscoveryEngineStructuredDocumentResult"},{"$ref":"#/components/schemas/DiscoveryEngineUnstructuredDocumentResult"}],"title":"Document"},"model_scores":{"$ref":"#/components/schemas/DiscoveryEngineModelScoresResult"}},"type":"object","required":["document","model_scores"],"title":"DiscoveryEngineSearchResult"},"DiscoveryEngineStructuredDocumentResult":{"properties":{"body":{"type":"string","title":"Body"},"link":{"type":"string","title":"Link"},"title":{"type":"string","title":"Title"},"sequenced_group_name":{"type":"string","title":"Sequenced Group Name"},"dataset_name":{"type":"string","title":"Dataset Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["body","link","title","sequenced_group_name","dataset_name","description"],"title":"DiscoveryEngineStructuredDocumentResult"},"DiscoveryEngineUnstructuredDocumentResult":{"properties":{"extractive_answers":{"items":{"type":"string"},"type":"array","title":"Extractive Answers"},"link":{"type":"string","title":"Link"},"title":{"type":"string","title":"Title"}},"type":"object","required":["extractive_answers","link","title"],"title":"DiscoveryEngineUnstructuredDocumentResult"},"DomainCitation":{"properties":{"domain":{"type":"string","title":"Domain"},"best_position":{"type":"integer","title":"Best Position"}},"type":"object","required":["domain","best_position"],"title":"DomainCitation"},"DomainsAnalysis":{"properties":{"domains_citations":{"items":{"$ref":"#/components/schemas/DomainCitation"},"type":"array","title":"Domains Citations"},"best_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Best Position"},"best_position_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Position Url"},"nb_urls_matching_domain":{"type":"integer","title":"Nb Urls Matching Domain"}},"type":"object","required":["domains_citations","best_position","best_position_url","nb_urls_matching_domain"],"title":"DomainsAnalysis"},"EmbedConfig":{"properties":{"model":{"type":"string","const":"text-multilingual-embedding-002","title":"Model","description":"The embedding model to use","default":"text-multilingual-embedding-002"}},"type":"object","title":"EmbedConfig"},"EmbedItem":{"properties":{"text":{"type":"string","title":"Text","description":"The text to generate an embedding for"}},"type":"object","required":["text"],"title":"EmbedItem"},"EmbedProcessedItem":{"properties":{"embedding":{"items":{"type":"number"},"type":"array","title":"Embedding","description":"The embedding vector as a list of floats"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["embedding","status"],"title":"EmbedProcessedItem"},"Entity":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"types":{"items":{"type":"string"},"type":"array","title":"Types"},"result_score":{"type":"number","title":"Result Score","default":0.0},"url":{"type":"string","title":"Url","default":""},"image":{"type":"string","title":"Image","default":""},"detailed_description":{"type":"string","title":"Detailed Description","default":""},"detailed_description_url":{"type":"string","title":"Detailed Description Url","default":""}},"type":"object","required":["name"],"title":"Entity"},"Error":{"properties":{"type":{"type":"string","title":"Type","description":"Type of the error"},"message":{"type":"string","title":"Message","description":"Cause of the error"},"stacktrace":{"type":"string","title":"Stacktrace","description":"Trace of the error"},"status":{"type":"string","const":"error","title":"Status","readOnly":true}},"type":"object","required":["type","message","stacktrace","status"],"title":"Error","description":"Error with message."},"Expectation":{"properties":{"field":{"type":"string","title":"Field","description":"Name of the extracted JSON field to check. Supports dotted paths for nested objects (e.g. ``dimensions.width``)."},"operator":{"type":"string","enum":["equals","contains","matches_regex","gt","gte","lt","lte"],"title":"Operator","description":"Predicate applied between the actual value and ``expected_value`` (scalar expectations) or between the array length and ``expected_length`` (length expectations). Defaults to ``equals``. Length expectations support only ``equals`` / ``gt`` / ``gte`` / ``lt`` / ``lte``.","default":"equals"},"expected_value":{"anyOf":[{},{"type":"null"}],"title":"Expected Value","description":"Expected scalar value (set when the field is a scalar)"},"expected_array_items":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/ArrayItemMatch"},{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]},"type":"array"},{"type":"null"}],"title":"Expected Array Items","description":"Patterns to match against array items (set when the field is an array). Each pattern is either a scalar — the array must contain an item equal to it (use this for arrays of strings or numbers, e.g. image URLs) — or a sub-object of fields, in which case at least one array item must match all the listed fields. For each pattern, at least one item must match."},"expected_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expected Length","description":"Expected number of items of an array field (set to assert on the array length). Combined with ``operator`` (equals / gt / gte / lt / lte)."},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"Free-form note describing how to locate this field on the page. Never used by the evaluator — purely informational."}},"type":"object","required":["field"],"title":"Expectation","description":"An expectation about a single field of the extracted JSON.\n\nExactly one of ``expected_value`` (for scalar fields),\n``expected_array_items`` (for array-item patterns) or\n``expected_length`` (for the length of an array field) must be set. The\n``operator`` is only meaningful for scalar and length expectations."},"ExpectationFailure":{"properties":{"attribute":{"type":"string","title":"Attribute","description":"The (possibly dotted) field that failed"},"expected":{"anyOf":[{},{"type":"null"}],"title":"Expected","description":"What was expected (scalar value or array patterns)"},"result":{"anyOf":[{},{"type":"null"}],"title":"Result","description":"The value actually extracted (None when absent/null)"},"message":{"type":"string","title":"Message","description":"Human-readable error message"}},"type":"object","required":["attribute","message"],"title":"ExpectationFailure","description":"A single expectation that did not hold against the extracted JSON."},"ExtraValue":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/ExtraValue"},"type":"object"},{"items":{"$ref":"#/components/schemas/ExtraValue"},"type":"array"},{"type":"string","contentMediaType":"application/octet-stream"},{"type":"string"},{"type":"boolean"},{"type":"integer"},{"type":"number"},{"type":"null"}]},"ExtractResult":{"properties":{"value":{"anyOf":[{},{"type":"null"}],"title":"Value"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"ExtractResult"},"FieldMetadata":{"properties":{"period_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Comment"}},"type":"object","title":"FieldMetadata"},"FileFormat":{"type":"string","enum":["auto","jsonl","csv","tsv"]},"FileSink":{"properties":{"type":{"type":"string","const":"file","title":"Type","default":"file"},"gzip":{"type":"boolean","title":"Gzip","description":"Compress the output.","default":true}},"type":"object","title":"FileSink","description":"A temporary JSONL file in project storage, readable back as a source."},"FileSource":{"properties":{"type":{"type":"string","const":"file","title":"Type","default":"file"},"url":{"type":"string","title":"Url","description":"File URL. Upload a local file at https://app.botify.com/:organization/:project/o/storage/tmp and pass the returned URL, or reuse the sink URL of a previous batch. Public HTTP(S) URLs are accepted too. CSV, TSV and JSONL, gzip allowed."},"format":{"$ref":"#/components/schemas/FileFormat","description":"File format, or auto-detect.","default":"auto"}},"type":"object","required":["url"],"title":"FileSource","description":"Rows from an uploaded CSV/TSV, or from a previous batch's JSONL output."},"FilteredCTRMetrics":{"properties":{"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"},"ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr"},"avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Position"},"desktop_tablet_impressions":{"type":"integer","title":"Desktop Tablet Impressions"},"desktop_tablet_clicks":{"type":"integer","title":"Desktop Tablet Clicks"},"desktop_tablet_ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Desktop Tablet Ctr"},"desktop_tablet_avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Desktop Tablet Avg Position"},"mobile_impressions":{"type":"integer","title":"Mobile Impressions"},"mobile_clicks":{"type":"integer","title":"Mobile Clicks"},"mobile_ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mobile Ctr"},"mobile_avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mobile Avg Position"}},"type":"object","required":["impressions","clicks","ctr","avg_position","desktop_tablet_impressions","desktop_tablet_clicks","desktop_tablet_ctr","desktop_tablet_avg_position","mobile_impressions","mobile_clicks","mobile_ctr","mobile_avg_position"],"title":"FilteredCTRMetrics"},"Gemini31FlashSettings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"model":{"type":"string","const":"gemini-3.1-flash-lite","title":"Model","description":"The model to use for the Gemini model"},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","flex_only"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for Google Models: 'default', 'flex', or 'flex_only'."},"thinking_level":{"anyOf":[{"type":"string","enum":["minimal","low","medium","high"]},{"type":"null"}],"title":"Thinking Level","description":"Thinking level: 'minimal', 'low', 'medium', or 'high'. Controls the depth of reasoning."}},"type":"object","required":["model"],"title":"Gemini31FlashSettings","description":"Settings specific to Gemini 3.1 Flash model"},"Gemini31Settings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"model":{"type":"string","const":"gemini-3.1-pro-preview","title":"Model","description":"The model to use for the Gemini model"},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","flex_only"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for Google Models: 'default', 'flex', or 'flex_only'."},"thinking_level":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Thinking Level","description":"Thinking level: 'low', 'medium', or 'high'. Controls the depth of reasoning."}},"type":"object","required":["model"],"title":"Gemini31Settings","description":"Settings specific to Gemini 3.1 models"},"Gemini35FlashSettings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"model":{"type":"string","const":"gemini-3.5-flash","title":"Model","description":"The model to use for the Gemini model"},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","flex_only"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for Google Models: 'default', 'flex', or 'flex_only'."},"thinking_level":{"anyOf":[{"type":"string","enum":["minimal","low","medium","high"]},{"type":"null"}],"title":"Thinking Level","description":"Thinking level: 'minimal', 'low', 'medium', or 'high'. Controls the depth of reasoning."}},"type":"object","required":["model"],"title":"Gemini35FlashSettings","description":"Settings specific to Gemini 3.5 Flash model"},"Gemini3FlashSettings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"model":{"type":"string","const":"gemini-3-flash-preview","title":"Model","description":"The model to use for the Gemini model"},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","flex_only"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for Google Models: 'default', 'flex', or 'flex_only'."},"thinking_level":{"anyOf":[{"type":"string","enum":["minimal","low","medium","high"]},{"type":"null"}],"title":"Thinking Level","description":"Thinking level: 'minimal', 'low', 'medium', or 'high'. Controls the depth of reasoning."}},"type":"object","required":["model"],"title":"Gemini3FlashSettings","description":"Settings specific to Gemini 3 Flash model"},"GeminiImageElement":{"properties":{"type":{"type":"string","title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"}},"type":"object","required":["type"],"title":"GeminiImageElement","description":"An image element inside a gemini_images item."},"GeminiLLMScraperResult":{"properties":{"keyword":{"type":"string","title":"Keyword"},"location_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Code"},"language_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language Code"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datetime"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"sources":{"anyOf":[{"items":{"$ref":"#/components/schemas/GeminiSource"},"type":"array"},{"type":"null"}],"title":"Sources"},"se_results_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Se Results Count"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"items_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Items Count"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/GeminiResponseItem"},"type":"array"},{"type":"null"}],"title":"Items"}},"type":"object","required":["keyword"],"title":"GeminiLLMScraperResult","description":"Result from the Gemini LLM scraper."},"GeminiResponseItem":{"properties":{"type":{"type":"string","title":"Type"},"rank_group":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Group"},"rank_absolute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Absolute"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"original_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Text"},"sources":{"anyOf":[{"items":{"$ref":"#/components/schemas/GeminiSource"},"type":"array"},{"type":"null"}],"title":"Sources"},"table":{"anyOf":[{"$ref":"#/components/schemas/GeminiTable"},{"type":"null"}]},"items":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/GeminiImageElement"},{"additionalProperties":true,"type":"object"}]},"type":"array"},{"type":"null"}],"title":"Items"}},"additionalProperties":true,"type":"object","required":["type"],"title":"GeminiResponseItem","description":"A response item from Gemini LLM Scraper.\n\nCan be of types: gemini_text, gemini_table, gemini_images."},"GeminiSource":{"properties":{"type":{"type":"string","title":"Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"},"publication_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publication Date"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"}},"type":"object","required":["type"],"title":"GeminiSource","description":"A source cited by Gemini in its response."},"GeminiTable":{"properties":{"table_header":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Table Header"},"table_content":{"anyOf":[{"items":{"items":{"type":"string"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Table Content"}},"type":"object","title":"GeminiTable","description":"A table structure in Gemini's response."},"GetCreditUsageProcessedItem":{"properties":{"credit_status":{"type":"string","enum":["healthy","warning","over","blocked"],"title":"Credit Status","description":"Where the project stands overall: the worse of the daily and the monthly credit status"},"daily":{"$ref":"#/components/schemas/CreditWindow","description":"Information about the daily allowance usage"},"monthly":{"$ref":"#/components/schemas/CreditWindow","description":"Information about the monthly allowance usage"},"summary":{"type":"string","title":"Summary","description":"A paragraph summarizing where usage sits expressed in natural language"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["credit_status","daily","monthly","summary","status"],"title":"GetCreditUsageProcessedItem"},"GooglAiOverviewReference":{"properties":{"type":{"type":"string","title":"Type"},"source":{"type":"string","title":"Source"},"domain":{"type":"string","title":"Domain"},"url":{"type":"string","title":"Url"},"title":{"type":"string","title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["type","source","domain","url","title"],"title":"GooglAiOverviewReference"},"GoogleAdsKeywordSuggestionsConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GoogleAdsKeywordSuggestionsConfig"},"GoogleAdsKeywordSuggestionsItem":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Keywords","description":"List of seed keywords"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request, will translate to location ID","examples":["Paris, FR"]}},"type":"object","required":["keywords"],"title":"GoogleAdsKeywordSuggestionsItem"},"GoogleAdsKeywordSuggestionsProcessedItem":{"properties":{"location":{"$ref":"#/components/schemas/SearchLocation"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["location","results","status"],"title":"GoogleAdsKeywordSuggestionsProcessedItem"},"GoogleAdsSearchVolumeItem":{"properties":{"query":{"type":"string","maxLength":80,"title":"Query","description":"The keyword to analyze. Limited to 80 characters."}},"type":"object","required":["query"],"title":"GoogleAdsSearchVolumeItem"},"GoogleAdsSearchVolumeProcessedItem":{"properties":{"keyword":{"type":"string","title":"Keyword","description":"The keyword that was searched"},"search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Volume","description":"Monthly average search volume"},"competition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competition","description":"Competition level (HIGH, MEDIUM, LOW)"},"competition_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Competition Index","description":"Competition index (0-100)"},"cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpc","description":"Cost per click"},"low_top_of_page_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low Top Of Page Bid","description":"Minimum bid for top of page"},"high_top_of_page_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High Top Of Page Bid","description":"Maximum bid for top of page"},"monthly_searches":{"anyOf":[{"items":{"$ref":"#/components/schemas/MonthlySearchData"},"type":"array"},{"type":"null"}],"title":"Monthly Searches","description":"Monthly search volume data"},"location_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Code","description":"Location code used for search"},"language_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language Code","description":"Language code used for search"},"search_partners":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Search Partners","description":"Whether search partners data is included"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["keyword","search_volume","competition","competition_index","cpc","low_top_of_page_bid","high_top_of_page_bid","monthly_searches","location_code","language_code","search_partners","status"],"title":"GoogleAdsSearchVolumeProcessedItem","description":"Processed item containing Google Ads search volume data."},"GoogleAiModeConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GoogleAiModeConfig"},"GoogleAiModeItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GoogleAiModeItem"},"GoogleAiModeProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The original search query"},"location_name":{"type":"string","title":"Location Name","description":"The location used for the search, if any"},"results":{"$ref":"#/components/schemas/GoogleAiModeResults","description":"The AI-generated search results"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","location_name","results","status"],"title":"GoogleAiModeProcessedItem"},"GoogleAiModeResults":{"properties":{"type":{"type":"string","const":"ai_mode","title":"Type","default":"ai_mode"},"rank_group":{"type":"integer","title":"Rank Group"},"rank_absolute":{"type":"integer","title":"Rank Absolute"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"items":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiOverviewElement"},{"additionalProperties":true,"type":"object"}]},"type":"array"},{"type":"null"}],"title":"Items"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Name / version of the model used"}},"type":"object","required":["rank_group","rank_absolute","markdown"],"title":"GoogleAiModeResults"},"GoogleAiOverviewConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GoogleAiOverviewConfig"},"GoogleAiOverviewElement":{"properties":{"type":{"type":"string","title":"Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"links":{"anyOf":[{"items":{"$ref":"#/components/schemas/GoogleAiOverviewLinkElement"},"type":"array"},{"type":"null"}],"title":"Links"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/GoogleAiOverviewImageElement"},"type":"array"},{"type":"null"}],"title":"Images"},"references":{"anyOf":[{"items":{"$ref":"#/components/schemas/GooglAiOverviewReference"},"type":"array"},{"type":"null"}],"title":"References"}},"type":"object","required":["type"],"title":"GoogleAiOverviewElement"},"GoogleAiOverviewImageElement":{"properties":{"type":{"type":"string","title":"Type"},"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"image_url":{"type":"string","title":"Image Url"}},"type":"object","required":["type","image_url"],"title":"GoogleAiOverviewImageElement"},"GoogleAiOverviewItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GoogleAiOverviewItem"},"GoogleAiOverviewLinkElement":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},"type":"object","required":["type","title"],"title":"GoogleAiOverviewLinkElement"},"GoogleAiOverviewProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The original search query"},"location_name":{"type":"string","title":"Location Name","description":"The location used for the search, if any"},"results":{"$ref":"#/components/schemas/GoogleAiOverviewResults","description":"The AI-generated search results"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","location_name","results","status"],"title":"GoogleAiOverviewProcessedItem"},"GoogleAiOverviewResults":{"properties":{"type":{"type":"string","title":"Type"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"items":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/GoogleAiOverviewElement"},{"additionalProperties":true,"type":"object"}]},"type":"array"},{"type":"null"}],"title":"Items"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Name / version of the model used"}},"type":"object","required":["type"],"title":"GoogleAiOverviewResults"},"GoogleGeminiConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GoogleGeminiConfig"},"GoogleGeminiItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GoogleGeminiItem"},"GoogleGeminiProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The original search query"},"location_name":{"type":"string","title":"Location Name","description":"The location used for the search, if any"},"results":{"$ref":"#/components/schemas/GeminiLLMScraperResult","description":"The Gemini search results"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","location_name","results","status"],"title":"GoogleGeminiProcessedItem"},"GoogleKnowledgeGraphConfig":{"properties":{"limit":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Result limit","description":"Maximum number of entities to return (1-50)","default":10},"types":{"items":{"type":"string"},"type":"array","title":"Entity Types","description":"Filter results by entity types (e.g., Person, Place, Organization)"},"languages":{"items":{"type":"string","pattern":"^[a-z]{2}$"},"type":"array","title":"Languages","description":"Filter results by language codes (e.g., en, fr, es)"}},"type":"object","title":"GoogleKnowledgeGraphConfig"},"GoogleKnowledgeGraphItem":{"properties":{"query":{"type":"string","minLength":1,"title":"Query","description":"The entity or topic to search for in the Knowledge Graph"}},"type":"object","required":["query"],"title":"GoogleKnowledgeGraphItem"},"GoogleKnowledgeGraphProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The search query that was executed"},"entities":{"items":{"$ref":"#/components/schemas/Entity"},"type":"array","title":"Entities","description":"List of found entities with their information"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of entities found"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","entities","total_count","status"],"title":"GoogleKnowledgeGraphProcessedItem"},"GooglePeopleAlsoAskConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GooglePeopleAlsoAskConfig"},"GooglePeopleAlsoAskItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GooglePeopleAlsoAskItem"},"GooglePeopleAlsoAskProcessedItem":{"properties":{"results":{"items":{"$ref":"#/components/schemas/PeopleAlsoAskItem"},"type":"array","title":"Results","description":"List of People Also Ask questions with their details"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["results","status"],"title":"GooglePeopleAlsoAskProcessedItem"},"GooglePeopleAlsoSearchConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GooglePeopleAlsoSearchConfig"},"GooglePeopleAlsoSearchItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GooglePeopleAlsoSearchItem"},"GooglePeopleAlsoSearchProcessedItem":{"properties":{"results":{"items":{"type":"string"},"type":"array","title":"Results","description":"List of People Also Search questions with their details"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["results","status"],"title":"GooglePeopleAlsoSearchProcessedItem"},"GooglePositionOpportunitiesConfig":{"properties":{},"type":"object","title":"GooglePositionOpportunitiesConfig"},"GooglePositionOpportunitiesItem":{"properties":{"period":{"type":"string","enum":["last_7d","last_28d"],"title":"Period","description":"Time period to analyze"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Specific URL to analyze (optional)"},"keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keyword","description":"Specific keyword to analyze (optional)"}},"type":"object","required":["period"],"title":"GooglePositionOpportunitiesItem"},"GooglePositionOpportunitiesProcessedItem":{"properties":{"global_ctr_mobile":{"items":{"$ref":"#/components/schemas/CTRDataPoint"},"type":"array","title":"Global Ctr Mobile","description":"Global CTR data for mobile devices by position"},"global_ctr_desktop_and_tablet":{"items":{"$ref":"#/components/schemas/CTRDataPoint"},"type":"array","title":"Global Ctr Desktop And Tablet","description":"Global CTR data for desktop and tablet devices by position"},"ctr_for_filter":{"anyOf":[{"items":{"$ref":"#/components/schemas/FilteredCTRMetrics"},"type":"array"},{"type":"null"}],"title":"Ctr For Filter","description":"CTR metrics for the specific URL or keyword filter"},"opportunities":{"anyOf":[{"$ref":"#/components/schemas/OpportunitiesByDevice"},{"type":"null"}],"description":"Potential additional clicks by improving to each position"},"opportunities_explanations":{"type":"string","title":"Opportunities Explanations","description":"Explanation of what the opportunities data represents"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["global_ctr_mobile","global_ctr_desktop_and_tablet","ctr_for_filter","opportunities","opportunities_explanations","status"],"title":"GooglePositionOpportunitiesProcessedItem"},"GoogleSearchConfig":{"properties":{"location_request":{"type":"string","title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search","default":"mobile"}},"type":"object","required":["location_request"],"title":"GoogleSearchConfig"},"GoogleSearchItem":{"properties":{"query":{"type":"string","title":"Query","description":"The search query to analyze"},"question":{"type":"string","title":"Question","description":"What do you want to know about the search results?"}},"type":"object","required":["query","question"],"title":"GoogleSearchItem"},"GoogleSearchProcessedItem":{"properties":{"answer":{"type":"string","title":"Answer","description":"The answer to the question"},"results":{"$ref":"#/components/schemas/GoogleSearchRawResults","description":"The SERP results used to generate the answer"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["answer","results","status"],"title":"GoogleSearchProcessedItem"},"GoogleSearchRawConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"},"limit":{"type":"integer","title":"Limit","description":"Limit the number of results (optional - defaults to 30)","default":30},"data_level":{"type":"string","enum":["main","all"],"title":"Data Level","description":"Should we return just main information (item_type (organic, shopping, knowledge_graph, people_also_ask, people_also_search...), title, description, rank), or all information (featured snippets, ratings, prices, refinement chips...)","default":"main"}},"type":"object","title":"GoogleSearchRawConfig"},"GoogleSearchRawItem":{"properties":{"query":{"type":"string","maxLength":700,"title":"Query","description":"The search query to analyze"}},"type":"object","required":["query"],"title":"GoogleSearchRawItem"},"GoogleSearchRawProcessedItem":{"properties":{"results":{"$ref":"#/components/schemas/GoogleSearchRawResults","description":"The SERP results"},"location_name":{"type":"string","title":"Location Name","description":"description of output2"},"query":{"type":"string","title":"Query","description":"The search query to analyze"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["results","location_name","query","status"],"title":"GoogleSearchRawProcessedItem"},"GoogleSearchRawResults":{"properties":{"keyword":{"type":"string","title":"Keyword"},"type":{"type":"string","title":"Type"},"se_domain":{"type":"string","title":"Se Domain"},"location_code":{"type":"integer","title":"Location Code"},"language_code":{"type":"string","title":"Language Code"},"check_url":{"type":"string","title":"Check Url"},"datetime":{"type":"string","title":"Datetime"},"spell":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spell"},"item_types":{"items":{"type":"string"},"type":"array","title":"Item Types"},"se_results_count":{"type":"integer","title":"Se Results Count"},"items_count":{"type":"integer","title":"Items Count"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"}},"type":"object","required":["keyword","type","se_domain","location_code","language_code","check_url","datetime","spell","item_types","se_results_count","items_count","items"],"title":"GoogleSearchRawResults"},"GoogleTrendsConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"GoogleTrendsConfig"},"GoogleTrendsItem":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Keywords","description":"List of keywords to analyze (up to 5)"}},"type":"object","required":["keywords"],"title":"GoogleTrendsItem"},"GoogleTrendsProcessedItem":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"List of keywords analyzed"},"date_from":{"type":"string","title":"Date From","description":"Start date of the trends data in YYYY-MM-DD format"},"date_to":{"type":"string","title":"Date To","description":"End date of the trends data in YYYY-MM-DD format"},"graph":{"anyOf":[{"additionalProperties":true,"type":"object","description":"Graph data showing search interest over time"},{"type":"null"}],"title":"Graph"},"topics":{"anyOf":[{"additionalProperties":true,"type":"object","description":"Topics data related to the keywords"},{"type":"null"}],"title":"Topics"},"queries":{"anyOf":[{"additionalProperties":true,"type":"object","description":"Queries data related to the keywords"},{"type":"null"}],"title":"Queries"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["keywords","date_from","date_to","status"],"title":"GoogleTrendsProcessedItem"},"GoogleURLInspectionConfig":{"properties":{"include_summary":{"type":"boolean","title":"Include Summary","description":"When true, generate an LLM summary of the inspection; when false, summary is null.","default":true}},"type":"object","title":"GoogleURLInspectionConfig"},"GoogleURLInspectionItem":{"properties":{"url":{"type":"string","title":"URL","description":"The URL to inspect"}},"type":"object","required":["url"],"title":"GoogleURLInspectionItem"},"GoogleURLInspectionProcessedItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL that was inspected"},"inspection_result":{"additionalProperties":true,"type":"object","title":"Inspection Result","description":"The result of the URL inspection"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Summary of the URL inspection result; null when disabled"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["url","inspection_result","summary","status"],"title":"GoogleURLInspectionProcessedItem"},"HTMLExecutorConfig":{"properties":{"function":{"type":"string","title":"JavaScript Function","description":"JavaScript function to execute on the HTML. Should be in the format 'function() { ... }' and return the extracted data."}},"type":"object","required":["function"],"title":"HTMLExecutorConfig","description":"Configuration for HTML executor agent."},"HTMLExecutorItem":{"properties":{"url":{"type":"string","title":"URL","description":"URL to execute the JavaScript function on. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed."},"expectations":{"items":{"$ref":"#/components/schemas/Expectation"},"type":"array","title":"Expectations","description":"Quality control expectations the extracted result must satisfy. When provided, the agent evaluates them against the extracted JSON and reports any failures.","default":[]}},"type":"object","required":["url"],"title":"HTMLExecutorItem","description":"Input item for HTML executor agent."},"HTMLExecutorProcessedItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL that was processed"},"crawl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Crawl","description":"Crawl Slug from SiteCrawler"},"url_found":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Url Found","description":"Whether the URL was found in the crawl index","default":false},"result":{"anyOf":[{},{"type":"null"}],"title":"Result","description":"Result of executing the function on the HTML"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error if function execution failed"},"quality_control_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quality Control Passed","description":"True when every expectation holds against the extracted result, False when at least one fails, None when no expectations were provided."},"quality_control_failures":{"items":{"$ref":"#/components/schemas/ExpectationFailure"},"type":"array","title":"Quality Control Failures","description":"One entry per failed expectation (empty when passed or when no expectations were provided).","default":[]},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["url","status"],"title":"HTMLExecutorProcessedItem","description":"Output from HTML executor agent."},"HTMLExtractImage":{"properties":{"image_url":{"type":"string","title":"Image Url","description":"Image URL. If the image is relative, make it absolute (user will provide the domain)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Title (if available from alt text, title attribute or nearby headings)"},"copyright":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Copyright","description":"Copyright information (if available)"}},"type":"object","required":["image_url","title","copyright"],"title":"HTMLExtractImage"},"HTMLExtractImagesConfig":{"properties":{},"type":"object","title":"HTMLExtractImagesConfig"},"HTMLExtractImagesItem":{"properties":{"url":{"type":"string","title":"URL","description":"The URL to extract images fro"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"The country code to use for the real-time fetch. 2 letters lowercase.","default":"us"}},"type":"object","required":["url"],"title":"HTMLExtractImagesItem"},"HTMLExtractImagesProcessedItem":{"properties":{"images":{"items":{"$ref":"#/components/schemas/HTMLExtractImage"},"type":"array","title":"Images","description":"The list of images extracted from the HTML page"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["images","status"],"title":"HTMLExtractImagesProcessedItem"},"HTMLFetchConfig":{"properties":{},"type":"object","title":"HTMLFetchConfig"},"HTMLFetchItem":{"properties":{"url":{"type":"string","title":"URL","description":"The URL to fetch HTML for. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed."},"origin":{"$ref":"#/components/schemas/OriginEnum","title":"Origin","description":"The origin of the URL","default":"site_crawler","enumNames":["Botify SiteCrawler","Real Time Fetch URL","Rendering Farm","Temporary upload"]},"country_code":{"type":"string","title":"Country Code","description":"The country code to use for the real-time fetch. 2 letters lowercase","default":"us"},"fallback_real_time_fetch":{"type":"boolean","title":"Fallback To Real Time Fetch","description":"Fallback to real_time_fetch_url if the URL is not found in SiteCrawler","default":false},"only_text":{"type":"boolean","title":"Only Text","description":"Only return the text of the page","default":false},"only_body":{"type":"boolean","title":"Only Body","description":"Only return the body of the page","default":false},"remove_tags":{"items":{"type":"string","title":"Tag","description":"The tag to remove"},"type":"array","title":"Remove Tags","description":"Remove all tags from the HTML","default":["script","noscript","style","header","footer","nav","aside","form","svg","iframe"]},"save_to_tmp_storage":{"type":"boolean","title":"Save To Temporary Storage","description":"Save the fetched HTML to Botify temporary storage and return the temporary URL instead of the HTML. Use this to save output tokens. The returned URL can be passed to other HTML-processing tools.","default":false}},"type":"object","required":["url"],"title":"HTMLFetchItem"},"HTMLFetchProcessedItem":{"properties":{"origin":{"anyOf":[{"$ref":"#/components/schemas/OriginEnum"},{"type":"null"}],"description":"The origin of the HTML (site_crawler, real_time_fetch_url, rendering_farm, or temporary_upload)"},"crawl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Crawl","description":"Crawl Slug from SiteCrawler"},"html":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html","description":"HTML content of the page. Omitted when `save_to_tmp_storage` is True; see `html_tmp_storage_url` instead."},"html_tmp_storage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Tmp Storage Url","description":"Temporary storage URL of the HTML page. Returned instead of `html` when `save_to_tmp_storage` is True. Can be passed to other HTML-processing tools."},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code","description":"HTTP status code of the response"},"headers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Headers","description":"HTTP headers of the response"},"iframe_allowed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Iframe Allowed","description":"Whether iframes are allowed in the response"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason for failure, if any"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["status"],"title":"HTMLFetchProcessedItem"},"HTMLQuestionConfig":{"properties":{"tone_of_voice":{"type":"string","title":"Tone Of Voice","description":"IA tone of voice","default":""},"response_lang":{"type":"string","title":"Response Lang","description":"Language of the response (must be a BCP47 lang code or 'auto' (default) to use the HTML page language)","default":"auto"},"country_code":{"type":"string","title":"Country Code","description":"Country code to use for real-time fetches (2 letters lowercase)","default":"us"},"remove_tags":{"items":{"type":"string"},"type":"array","title":"Remove Tags","description":"List of HTML tags to remove from the page before processing"},"only_text":{"type":"boolean","title":"Only Text","description":"If set to True, extract the text before the LLM","default":true},"fallback_real_time_fetch":{"type":"boolean","title":"Fallback Real Time Fetch","description":"Fall back to real-time ScrapingBee fetch when URL not in SiteCrawler","default":true}},"type":"object","title":"HTMLQuestionConfig"},"HTMLQuestionItem":{"properties":{"url":{"type":"string","title":"Url","description":"Source URL to ask question about"},"question":{"type":"string","title":"Question","description":"Question to ask"}},"type":"object","required":["url","question"],"title":"HTMLQuestionItem"},"HTMLQuestionProcessedItem":{"properties":{"url_found":{"type":"boolean","title":"Url Found","description":"Whether the URL was found and the HTML was fetched"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer","description":"Answer to given question (if the URL was found)"},"confidence_score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Confidence Score","description":"A score between 0 (lowest confidence) and 100 (best confidence) representing the confidence that the answer was accurately and completely extracted"},"url":{"type":"string","title":"Url","description":"Source URL used to answer the question"},"question":{"type":"string","title":"Question","description":"Question that was asked"},"iframe_allowed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Iframe Allowed","description":"Whether iframes are allowed in the answer"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["url_found","answer","confidence_score","url","question","status"],"title":"HTMLQuestionProcessedItem"},"HTMLStructuredData":{"properties":{"type":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Type","description":"JSON-LD @type: a single type name or a list of types (e.g. Book and Product)."},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"The structured data in JSON-LD format"}},"type":"object","required":["type","data"],"title":"HTMLStructuredData","description":"Represents a structured data object found in a page."},"HTMLStructuredDataConfig":{"properties":{"country_code":{"type":"string","title":"Country Code","description":"The country code to use for the real-time fetch. 2 letters lowercase","default":"us"},"types":{"items":{"type":"string"},"type":"array","title":"Types","description":"The types of structured data to extract. Will extract all if not provided."},"fallback_real_time_fetch":{"type":"boolean","title":"Fallback To Real Time Fetch","description":"Fallback to real_time_fetch_url if the URL is not found in SiteCrawler","default":false}},"type":"object","title":"HTMLStructuredDataConfig"},"HTMLStructuredDataItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL of the page to extract structured data from"}},"type":"object","required":["url"],"title":"HTMLStructuredDataItem"},"HTMLStructuredDataParsingError":{"properties":{"error":{"type":"string","title":"Error","description":"The error message"},"raw_json":{"type":"string","title":"Raw Json","description":"The raw JSON that caused the error"}},"type":"object","required":["error","raw_json"],"title":"HTMLStructuredDataParsingError","description":"Represents an error that occurred while parsing structured data."},"HTMLStructuredDataProcessedItem":{"properties":{"origin":{"anyOf":[{"$ref":"#/components/schemas/OriginEnum"},{"type":"null"}],"description":"The origin of the HTML (site_crawler, real_time_fetch_url, or rendering_farm)"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code","description":"HTTP status code of the fetched page"},"url_found":{"type":"boolean","title":"Url Found","description":"Whether the URL was found in the crawl","default":true},"objects":{"items":{"$ref":"#/components/schemas/HTMLStructuredData"},"type":"array","title":"Objects","description":"List of extracted structured data objects"},"has_objects":{"type":"boolean","title":"Has Objects","description":"Whether any structured data objects were found"},"has_errors":{"type":"boolean","title":"Has Errors","description":"Whether any errors were reported in `errors` (currently JSON-LD extraction/parsing; may include other kinds later)"},"errors":{"items":{"$ref":"#/components/schemas/HTMLStructuredDataParsingError"},"type":"array","title":"Errors","description":"List of errors encountered during extraction"},"title":{"type":"string","title":"Title","description":"Title indicating the source URL"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["objects","has_objects","has_errors","errors","title","status"],"title":"HTMLStructuredDataProcessedItem"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HtmlExtractorCssSelectorConfig":{"properties":{},"type":"object","title":"HtmlExtractorCssSelectorConfig"},"HtmlExtractorCssSelectorItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL to be used"},"extract_description":{"type":"string","title":"Extract Description","description":"The description of the element for which we want the CSS selector"}},"type":"object","required":["url","extract_description"],"title":"HtmlExtractorCssSelectorItem"},"HtmlExtractorCssSelectorProcessedItem":{"properties":{"crawl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Crawl","description":"If fetched from sitecrawler, the crawl where the URL was found","default":""},"css_selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Css Selector","description":"The CSS selector extracted for the user description","default":""},"preview":{"anyOf":[{"$ref":"#/components/schemas/CssSelectorPreview"},{"type":"null"}],"description":"Preview of the extracted data using the CSS selector"},"validation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation","description":"Validation status or error message","default":"Error during validation"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["status"],"title":"HtmlExtractorCssSelectorProcessedItem"},"HtmlGrepConfig":{"properties":{"queries":{"items":{"$ref":"#/components/schemas/HtmlGrepQuery"},"type":"array","minItems":1,"title":"Queries","description":"List of search queries to run against the fetched HTML. Each query is processed independently and shared by all items in a batch."}},"type":"object","required":["queries"],"title":"HtmlGrepConfig"},"HtmlGrepItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL to fetch the HTML from. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed."}},"type":"object","required":["url"],"title":"HtmlGrepItem"},"HtmlGrepMatch":{"properties":{"match":{"type":"string","title":"Match","description":"The exact substring that matched"},"context":{"type":"string","title":"Context","description":"The match with up to `n_chars` characters around it"},"start":{"type":"integer","title":"Start","description":"Start offset of the match in the HTML"},"end":{"type":"integer","title":"End","description":"End offset of the match in the HTML"}},"type":"object","required":["match","context","start","end"],"title":"HtmlGrepMatch"},"HtmlGrepProcessedItem":{"properties":{"crawl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Crawl","description":"If fetched from SiteCrawler, the crawl slug used"},"results":{"items":{"$ref":"#/components/schemas/HtmlGrepQueryResult"},"type":"array","title":"Results","description":"One result per input query, in the same order as `queries`.","default":[]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason for an empty result, if any"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["status"],"title":"HtmlGrepProcessedItem"},"HtmlGrepQuery":{"properties":{"expression":{"type":"string","minLength":1,"title":"Expression","description":"Expression to search in the HTML. Interpreted as a literal substring unless `is_regex` is True."},"n_chars":{"type":"integer","minimum":0.0,"title":"N Chars","description":"Number of characters of context to keep on each side of the match.","default":100},"is_regex":{"type":"boolean","title":"Is Regex","description":"If True, `expression` is interpreted as a Python regular expression. Otherwise, it is treated as a literal substring.","default":false},"case_sensitive":{"type":"boolean","title":"Case Sensitive","description":"If True, the search is case-sensitive.","default":true},"max_matches":{"type":"integer","title":"Max Matches","description":"Maximum number of matches returned for this query. Use 0 (or a negative value) to return all matches.","default":10}},"type":"object","required":["expression"],"title":"HtmlGrepQuery"},"HtmlGrepQueryResult":{"properties":{"query":{"$ref":"#/components/schemas/HtmlGrepQuery","description":"The query this result corresponds to (echoed back)"},"matches":{"items":{"$ref":"#/components/schemas/HtmlGrepMatch"},"type":"array","title":"Matches","description":"Matches found for this query, up to `max_matches`","default":[]},"total_matches":{"type":"integer","title":"Total Matches","description":"Total number of matches found in the HTML for this query (may be greater than `len(matches)` when truncated).","default":0},"truncated":{"type":"boolean","title":"Truncated","description":"True if results were truncated by `max_matches`.","default":false}},"type":"object","required":["query"],"title":"HtmlGrepQueryResult"},"HtmlLangConfig":{"properties":{"default_to":{"type":"string","title":"Default To","description":"If we don't find, return this value (if not empty) instead of an error.","default":""}},"type":"object","title":"HtmlLangConfig"},"HtmlLangItem":{"properties":{"html_code":{"type":"string","title":"Html Code","description":"HTML code of the page to process"}},"type":"object","required":["html_code"],"title":"HtmlLangItem"},"HtmlLangProcessedItem":{"properties":{"bcp47_lang_code":{"type":"string","title":"Bcp47 Lang Code","description":"BCP47 language code of the page"},"source":{"type":"string","title":"Source","description":"Source of the language code (html_attribute, llm or default)"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["bcp47_lang_code","source","status"],"title":"HtmlLangProcessedItem"},"HtmlPageWorkersPreviewConfig":{"properties":{},"type":"object","title":"HtmlPageWorkersPreviewConfig"},"HtmlPageWorkersPreviewItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL to be used"},"options":{"$ref":"#/components/schemas/PreviewOptions","description":"Preview options","default":{"use_liquid_engine":false}},"selectors":{"anyOf":[{"items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Selectors","description":"Optional list of extracts to preview. Each entry is an ExtractPreviewConfig object (kind: singleValue / multiValue / arrayOfObjects / jsonLd, with `type` for jsonLd) — the same shape as `extracts`. Config keys use snake_case (css_selector, container_selector, extract_type) and are converted to camelCase before hitting the JS engine. A bare string is also accepted as shorthand for a singleValue CSS selector (the legacy `list[str]` contract). Each entry returns the touched element descriptors plus the extracted value, serialized and truncated for display."},"templates":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Templates","description":"Optional list of PageWorkers templates to preview. Each entry should be a JSON stringified version of a template, with the `extract` and `context` fields."},"extracts":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Extracts","description":"Optional map of named extracts to resolve against the page. Each value follows the ExtractPreviewConfig shape (singleValue / multiValue / arrayOfObjects / jsonLd). Config keys use snake_case (css_selector, container_selector, extract_type) to match the rest of the API; they are converted to camelCase before being passed to the JS engine. Unlike templates, the raw extracted values are returned to the caller without template rendering or truncation."},"detect_json_ld_types":{"type":"boolean","title":"Detect Json Ld Types","description":"If true, return the list of unique @type values found in the page's JSON-LD blocks. Useful to discover what structured data is available before requesting an `extracts` with kind: jsonLd.","default":false}},"type":"object","required":["url"],"title":"HtmlPageWorkersPreviewItem"},"HtmlPageWorkersPreviewProcessedItem":{"properties":{"crawl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Crawl","description":"If fetched from sitecrawler, the crawl where the URL was found","default":""},"selectors_preview":{"anyOf":[{"items":{"$ref":"#/components/schemas/CssSelectorPreview"},"type":"array"},{"type":"null"}],"title":"Selectors Preview","description":"Preview of the elements matched by the CSS selectors"},"templates_preview":{"anyOf":[{"items":{"$ref":"#/components/schemas/TemplatePreview"},"type":"array"},{"type":"null"}],"title":"Templates Preview","description":"Preview of the rendered templates"},"extracts":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/ExtractResult"},"type":"object"},{"type":"null"}],"title":"Extracts","description":"Resolved extracts for the requested keys. Each entry holds the native extracted value and a per-key error if extraction failed for that key on this page."},"json_ld_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Json Ld Types","description":"Unique JSON-LD @type values present on the page, when `detect_json_ld_types` was requested."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["status"],"title":"HtmlPageWorkersPreviewProcessedItem"},"HtmlToTextConfig":{"properties":{},"type":"object","title":"HtmlToTextConfig"},"HtmlToTextItem":{"properties":{"html_code":{"type":"string","title":"Html Code","description":"HTML code of the page to process"}},"type":"object","required":["html_code"],"title":"HtmlToTextItem"},"HtmlToTextProcessedItem":{"properties":{"text":{"type":"string","title":"Text","description":"Text extracted from the html"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["text","status"],"title":"HtmlToTextProcessedItem"},"ImpactedMetric":{"properties":{"total_urls_affected":{"type":"integer","title":"Total Urls Affected"},"previous_total_urls_affected":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Total Urls Affected"},"active_urls_affected":{"type":"integer","title":"Active Urls Affected"},"previous_active_urls_affected":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Active Urls Affected"},"page_rank_impact":{"type":"number","title":"Page Rank Impact"},"previous_page_rank_impact":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Page Rank Impact"}},"type":"object","required":["total_urls_affected","previous_total_urls_affected","active_urls_affected","previous_active_urls_affected","page_rank_impact","previous_page_rank_impact"],"title":"ImpactedMetric"},"Item":{"properties":{},"type":"object","title":"Item","description":"Item to process (base class). Must be subclassed."},"JobState":{"type":"string","enum":["pending","running","cancelling","completed","failed","cancelled"]},"JobStatus":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Identifier to poll with."},"organization":{"type":"string","title":"Organization"},"project":{"type":"string","title":"Project"},"tool":{"type":"string","title":"Tool","description":"The tool being run over the records."},"state":{"$ref":"#/components/schemas/JobState","description":"Where the job is.","default":"pending"},"rows_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Total","description":"Records to process."},"rows_done":{"type":"integer","title":"Rows Done","description":"Records processed so far.","default":0},"rows_ok":{"type":"integer","title":"Rows Ok","description":"Records that succeeded.","default":0},"rows_error":{"type":"integer","title":"Rows Error","description":"Records that failed.","default":0},"estimated_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Credits","description":"Credits the batch was expected to cost."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"One line naming the source."},"sink":{"anyOf":[{"$ref":"#/components/schemas/SinkPointer"},{"type":"null"}],"description":"Where the output is being written."},"execution_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Id","description":"Underlying Cloud Run execution."},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Why the job failed, when it did."},"sample_errors":{"items":{"type":"string"},"type":"array","title":"Sample Errors","description":"First few per-record failures."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["job_id","organization","project","tool","created_at"],"title":"JobStatus","description":"One batch job, as seen from outside.\n\nWritten by the worker and read by the HTTP service, so it travels through a\nshared store rather than living in either process."},"KeywordPerformance":{"properties":{"keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keyword","description":"The keyword."},"clicks":{"type":"number","title":"Clicks","description":"Number of clicks."},"impressions":{"type":"number","title":"Impressions","description":"Number of impressions."},"position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Position","description":"Average position."},"ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr","description":"Click-through rate (CTR)."},"estimated_revenue":{"type":"number","title":"Estimated Revenue","description":"Estimated revenue for this keyword."},"predictions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Predictions","description":"Predicted metrics for different devices."},"smart_keyword_in_metadata":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Smart Keyword In Metadata","description":"Whether the keyword is present in the page title or description."}},"type":"object","required":["keyword","clicks","impressions","position","ctr","estimated_revenue","predictions"],"title":"KeywordPerformance"},"KeywordsCluster":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the keywords cluster"},"main_keyword":{"type":"string","title":"Main Keyword","description":"The main keyword representing the cluster"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"List of keywords belonging to this cluster"},"rationale":{"type":"string","title":"Rationale","description":"Explanation of why these keywords are grouped together"},"relevant_for_website":{"type":"boolean","title":"Relevant For Website","description":"Whether this cluster is relevant for the website based on its description"}},"type":"object","required":["name","main_keyword","keywords","rationale","relevant_for_website"],"title":"KeywordsCluster"},"KeywordsClusteringConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"KeywordsClusteringConfig"},"KeywordsClusteringItem":{"properties":{"tool_origin":{"type":"string","enum":["keywords_suggestions","keywords_suggestions_google_ads_planner"],"title":"Tool Origin","description":"Tool origin to get keywords from"},"language":{"type":"string","title":"Language","description":"Target language for clusters","default":"en"},"keywords":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Keywords","description":"List of keywords to cluster"}},"type":"object","required":["tool_origin","keywords"],"title":"KeywordsClusteringItem"},"KeywordsClusteringProcessedItem":{"properties":{"clusters":{"items":{"$ref":"#/components/schemas/KeywordsCluster"},"type":"array","title":"Clusters","description":"List of keyword clusters"},"website_description_used_for_clustering":{"type":"string","title":"Website Description Used For Clustering","description":"The website description that was used to assess cluster relevance"},"website_description_used_for_clustering__notes":{"type":"string","title":"Website Description Used For Clustering Notes","description":"Notes about the website description used for clustering"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["clusters","website_description_used_for_clustering","website_description_used_for_clustering__notes","status"],"title":"KeywordsClusteringProcessedItem"},"KeywordsExtractorConfig":{"properties":{"limit":{"type":"integer","title":"Limit","description":"Limit of top keywords to retrieve per URL","default":10},"start_date":{"type":"string","title":"Start Date","description":"Start date of the period (format YYYY-MM-DD)","default":"2026-08-17"},"end_date":{"type":"string","title":"End Date","description":"End date of the period","default":"2026-09-16"},"exclude_branded":{"type":"boolean","title":"Exclude Branded","description":"Whether to exclude branded keywords","default":true},"min_ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Ctr","description":"Minimum CTR to filter keywords (between 0 and 1)"},"sort":{"type":"string","enum":["impressions","clicks"],"title":"Sort","description":"Metric to sort keywords by (descending order)","default":"impressions"}},"type":"object","title":"KeywordsExtractorConfig"},"KeywordsExtractorEntity":{"properties":{"url":{"type":"string","title":"Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"}},"type":"object","required":["url","keywords"],"title":"KeywordsExtractorEntity"},"KeywordsExtractorItem":{"properties":{"urls":{"items":{"type":"string"},"type":"array","title":"Urls","description":"List of URLs we want to retrieve the keywords"}},"type":"object","required":["urls"],"title":"KeywordsExtractorItem"},"KeywordsExtractorProcessedItem":{"properties":{"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/KeywordsExtractorEntity"},"type":"array"},{"type":"null"}],"title":"Results","description":"List of keywords per URL"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["results","status"],"title":"KeywordsExtractorProcessedItem"},"KeywordsSuggestionsConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"KeywordsSuggestionsConfig"},"KeywordsSuggestionsGoogleAdsPlannerConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"KeywordsSuggestionsGoogleAdsPlannerConfig"},"KeywordsSuggestionsGoogleAdsPlannerItem":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Keywords","description":"List of keywords to get suggestions for"},"question":{"type":"string","title":"Question","description":"What data to get from the keywords"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location to get suggestions for."}},"type":"object","required":["keywords","question"],"title":"KeywordsSuggestionsGoogleAdsPlannerItem"},"KeywordsSuggestionsGoogleAdsPlannerProcessedItem":{"properties":{"answer":{"type":"string","title":"Answer","description":"The answer to the question"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"List of keyword data"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["answer","results","status"],"title":"KeywordsSuggestionsGoogleAdsPlannerProcessedItem"},"KeywordsSuggestionsItem":{"properties":{"seed_keyword":{"type":"string","title":"Seed Keyword","description":"Seed keyword to get suggestions for."},"question":{"type":"string","title":"Question","description":"What data to get from the keyword."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country for the analysis."}},"type":"object","required":["seed_keyword","question"],"title":"KeywordsSuggestionsItem"},"KeywordsSuggestionsProcessedItem":{"properties":{"answer":{"type":"string","title":"Answer","description":"Answer to the question."},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"List of keywords data."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["answer","results","status"],"title":"KeywordsSuggestionsProcessedItem"},"KnowledgeAgentConfig":{"properties":{},"type":"object","title":"KnowledgeAgentConfig"},"KnowledgeAgentItem":{"properties":{"query":{"type":"string","minLength":5,"title":"Query","description":"The question you want to ask to the Knowledge Agent"}},"type":"object","required":["query"],"title":"KnowledgeAgentItem"},"KnowledgeAgentProcessedItem":{"properties":{"search_results":{"items":{"$ref":"#/components/schemas/DiscoveryEngineSearchResult"},"type":"array","title":"Search Results","description":"List of search results used to generate the answer"},"answer":{"type":"string","title":"Answer","description":"The answer generated by the Knowledge Agent"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["search_results","answer","status"],"title":"KnowledgeAgentProcessedItem"},"LLMWrapperConfig":{"properties":{"prefeed":{"items":{"$ref":"#/components/schemas/PrefeedCall"},"type":"array","title":"Prefeed","description":"List of agent pre-calls whose results are injected into the user prompt before the LLM runs.","default":[]},"system_prompt":{"type":"string","title":"System Prompt","description":"System prompt used to generate the items","default":""},"structured_output_json_schema":{"additionalProperties":true,"type":"object","title":"Structured Output Json Schema","description":"JSON Schema for the structured output"},"model_settings":{"oneOf":[{"$ref":"#/components/schemas/Gemini3FlashSettings"},{"$ref":"#/components/schemas/Gemini31FlashSettings"},{"$ref":"#/components/schemas/Gemini31Settings"},{"$ref":"#/components/schemas/Gemini35FlashSettings"},{"$ref":"#/components/schemas/OpenAISettings"},{"$ref":"#/components/schemas/OpenAI52Settings"},{"$ref":"#/components/schemas/OpenAI54Settings"},{"$ref":"#/components/schemas/OpenAI55Settings"},{"$ref":"#/components/schemas/OpenAI56Settings"}],"title":"Model Settings","description":"The settings for the AI model","discriminator":{"propertyName":"model","mapping":{"gemini-3-flash-preview":"#/components/schemas/Gemini3FlashSettings","gemini-3.1-flash-lite":"#/components/schemas/Gemini31FlashSettings","gemini-3.1-pro-preview":"#/components/schemas/Gemini31Settings","gemini-3.5-flash":"#/components/schemas/Gemini35FlashSettings","gpt-5-mini":"#/components/schemas/OpenAISettings","gpt-5-nano":"#/components/schemas/OpenAISettings","gpt-5.1":"#/components/schemas/OpenAISettings","gpt-5.2":"#/components/schemas/OpenAI52Settings","gpt-5.4":"#/components/schemas/OpenAI54Settings","gpt-5.4-mini":"#/components/schemas/OpenAI54Settings","gpt-5.4-nano":"#/components/schemas/OpenAI54Settings","gpt-5.5":"#/components/schemas/OpenAI55Settings","gpt-5.6-luna":"#/components/schemas/OpenAI56Settings","gpt-5.6-terra":"#/components/schemas/OpenAI56Settings"}}},"agents":{"items":{"enum":["action_board","agentic_catalog_sources","botify_config","get_credit_usage","google_trends","html_code_executor","html_code_executor_batch","html_fetch","html_grep","html_grep_batch","html_question","knowledge","list_annotations","perplexity","quality_control","screenshot","tables_create","tables_insert","tables_list","tables_load","tables_query","tables_schema","text_hash","tool_documentation","topics_extractor","web_search"]},"type":"array","title":"Agents","description":"List of agent IDs to be used as tools."},"is_gzip":{"type":"boolean","title":"Is Gzip","description":"If True, the user_prompt is expected to be base64-encoded and gzip-compressed. The agent will decode base64, then decompress gzip, and use the resulting UTF-8 string as the prompt. Enable this if your prompt is transmitted in this format, regardless of the processing mode (batch or not). This can be used to reduce payload size in any context.","default":false},"toon_tool_results":{"type":"boolean","title":"Toon Tool Results","description":"Serialize agent tool results as TOON instead of JSON","default":false}},"type":"object","required":["structured_output_json_schema","model_settings"],"title":"LLMWrapperConfig","description":"Configuration for AI text generation"},"LLMWrapperItem":{"properties":{"prefeed":{"items":{"$ref":"#/components/schemas/PrefeedCall"},"type":"array","title":"Prefeed","description":"List of agent pre-calls whose results are injected into the user prompt before the LLM runs.","default":[]},"user_prompt":{"type":"string","title":"User Prompt","description":"User prompt for the LLM"}},"type":"object","required":["user_prompt"],"title":"LLMWrapperItem","description":"Input item for AI text generation"},"LLMWrapperProcessedItem":{"properties":{"structured_output":{"additionalProperties":true,"type":"object","title":"Structured Output","description":"Structured output based on input configuration"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["structured_output","status"],"title":"LLMWrapperProcessedItem","description":"Output from AI text generation"},"Link-Input":{"properties":{"url":{"type":"string","title":"Url"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["url"],"title":"Link"},"ListAnnotationsItem":{"properties":{"period_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period Start","description":"Optional inclusive start of the period filter (ISO date, e.g. 2024-01-01). Annotations whose start_date falls within this period are returned."},"period_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period End","description":"Optional inclusive end of the period filter (ISO date, e.g. 2024-12-31). Annotations whose start_date falls within this period are returned."}},"type":"object","title":"ListAnnotationsItem"},"ListAnnotationsProcessedItem":{"properties":{"annotations":{"items":{"$ref":"#/components/schemas/ChartAnnotation"},"type":"array","title":"Annotations","description":"Project chart annotations for the project"},"count":{"type":"integer","title":"Count","description":"Number of annotations returned after filtering"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of annotations on the project before filtering"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["annotations","count","total_count","status"],"title":"ListAnnotationsProcessedItem"},"Message":{"properties":{"id":{"type":"string","title":"Id","description":"The ID of the message"},"timestamp_us":{"type":"integer","title":"Timestamp Us","description":"The timestamp of the message in microseconds"},"namespace":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","title":"Namespace","description":"The namespace of the message"},"message":{"type":"string","maxLength":4096,"title":"Message","description":"The message content"},"extra":{"additionalProperties":{"$ref":"#/components/schemas/ExtraValue"},"type":"object","title":"Extra","description":"Extra data about the message"}},"type":"object","required":["namespace","message"],"title":"Message"},"MonthlySearchData":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"search_volume":{"type":"integer","title":"Search Volume"}},"type":"object","required":["year","month","search_volume"],"title":"MonthlySearchData","description":"Monthly search volume data for a keyword."},"NearestPageForTopicConfig":{"properties":{},"type":"object","title":"NearestPageForTopicConfig"},"NearestPageForTopicItem":{"properties":{"topic":{"type":"string","title":"Topic","description":"The topic to analyze."},"country":{"type":"string","title":"Country","description":"The country to search for."}},"type":"object","required":["topic","country"],"title":"NearestPageForTopicItem"},"NearestPageForTopicProcessedItem":{"properties":{"pages":{"items":{"$ref":"#/components/schemas/TopicPage"},"type":"array","title":"Pages","description":"List of evaluated topic pages."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["pages","status"],"title":"NearestPageForTopicProcessedItem"},"NodeStats":{"properties":{"node_id":{"type":"string","title":"Node Id"},"total_items":{"type":"integer","title":"Total Items","default":0},"in_flight_items":{"type":"integer","title":"In Flight Items","default":0},"failed_items":{"type":"integer","title":"Failed Items","default":0},"success_items":{"type":"integer","title":"Success Items","default":0},"all_tasks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"All Tasks"}},"type":"object","required":["node_id"],"title":"NodeStats","description":"Statistics for a node execution."},"NodeStatsSummary":{"properties":{"node_id":{"type":"string","title":"Node Id"},"total_items":{"type":"integer","title":"Total Items","default":0},"in_flight_items":{"type":"integer","title":"In Flight Items","default":0},"failed_items":{"type":"integer","title":"Failed Items","default":0},"success_items":{"type":"integer","title":"Success Items","default":0},"last_task":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Task","description":"Input/output of the last executed task"}},"type":"object","required":["node_id"],"title":"NodeStatsSummary","description":"Lightweight statistics for a node execution (counters only, no task details)."},"NodeTaskDetail":{"properties":{"node_id":{"type":"string","title":"Node Id","description":"Node ID"},"task_index":{"type":"integer","title":"Task Index","description":"Index of the task within the node"},"total_tasks":{"type":"integer","title":"Total Tasks","description":"Total number of tasks for this node"},"task":{"additionalProperties":true,"type":"object","title":"Task","description":"Full input/output details of the task"}},"type":"object","required":["node_id","task_index","total_tasks","task"],"title":"NodeTaskDetail","description":"Detailed task information for a specific node and task index."},"OnError":{"type":"string","enum":["skip","fail_job"]},"OpenAI52Settings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"verbosity":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Verbosity","description":"Text verbosity level: 'low', 'medium', or 'high'. Controls how concise or verbose the model's text response is."},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","priority"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for OpenAI API: 'default', 'flex', or 'priority'."},"model":{"type":"string","const":"gpt-5.2","title":"Model","description":"The model to use for the OpenAI model"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["low","medium","high","xhigh"]},{"type":"null"}],"title":"Reasoning Effort","description":"Reasoning effort level: 'low', 'medium', 'high', or 'xhigh'. Controls the depth of reasoning for reasoning models.","default":"high"}},"type":"object","required":["model"],"title":"OpenAI52Settings","description":"Settings specific to OpenAI 5.2 models"},"OpenAI54Settings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"verbosity":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Verbosity","description":"Text verbosity level: 'low', 'medium', or 'high'. Controls how concise or verbose the model's text response is."},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","priority"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for OpenAI API: 'default', 'flex', or 'priority'."},"model":{"type":"string","enum":["gpt-5.4","gpt-5.4-mini","gpt-5.4-nano"],"title":"Model","description":"The model to use for the OpenAI model"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["none","low","medium","high","xhigh"]},{"type":"null"}],"title":"Reasoning Effort","description":"Reasoning effort level: 'none', 'low', 'medium', 'high', or 'xhigh'. Controls the depth of reasoning for GPT-5.4 models."}},"type":"object","required":["model"],"title":"OpenAI54Settings","description":"Settings specific to OpenAI 5.4 models"},"OpenAI55Settings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"verbosity":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Verbosity","description":"Text verbosity level: 'low', 'medium', or 'high'. Controls how concise or verbose the model's text response is."},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","priority"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for OpenAI API: 'default', 'flex', or 'priority'."},"model":{"type":"string","const":"gpt-5.5","title":"Model","description":"The model to use for the OpenAI model"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["none","low","medium","high","xhigh"]},{"type":"null"}],"title":"Reasoning Effort","description":"Reasoning effort level: 'none', 'low', 'medium', 'high', or 'xhigh'. Controls the depth of reasoning for GPT-5.5 models."}},"type":"object","required":["model"],"title":"OpenAI55Settings","description":"Settings specific to OpenAI 5.5 models"},"OpenAI56Settings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"verbosity":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Verbosity","description":"Text verbosity level: 'low', 'medium', or 'high'. Controls how concise or verbose the model's text response is."},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","priority"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for OpenAI API: 'default', 'flex', or 'priority'."},"model":{"type":"string","enum":["gpt-5.6-luna","gpt-5.6-terra"],"title":"Model","description":"The model to use for the OpenAI model"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["none","low","medium","high","xhigh"]},{"type":"null"}],"title":"Reasoning Effort","description":"Reasoning effort level: 'none', 'low', 'medium', 'high', or 'xhigh'. Controls the depth of reasoning for GPT-5.6 models."}},"type":"object","required":["model"],"title":"OpenAI56Settings","description":"Settings specific to OpenAI 5.6 models"},"OpenAISettings":{"properties":{"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"The temperature for the AI model","default":0.3},"max_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Tokens","description":"The maximum number of tokens for the AI model"},"service_tier_flex_fallback_to_default":{"type":"boolean","title":"Service Tier Flex Fallback To Default","description":"If True and service_tier is 'flex'-like, fallback to 'default' tier on errors (429 rate limit, unsupported flex tier).","default":false},"verbosity":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Verbosity","description":"Text verbosity level: 'low', 'medium', or 'high'. Controls how concise or verbose the model's text response is."},"service_tier":{"anyOf":[{"type":"string","enum":["default","flex","priority"]},{"type":"null"}],"title":"Service Tier","description":"Service tier for OpenAI API: 'default', 'flex', or 'priority'."},"model":{"type":"string","enum":["gpt-5.1","gpt-5-mini","gpt-5-nano"],"title":"Model","description":"The model to use for the OpenAI model"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Reasoning Effort","description":"Reasoning effort level: 'low', 'medium', or 'high'. Controls the depth of reasoning for reasoning models."}},"type":"object","required":["model"],"title":"OpenAISettings","description":"Settings specific to OpenAI models"},"OpportunitiesByDevice":{"properties":{"mobile":{"items":{"$ref":"#/components/schemas/DeviceOpportunity"},"type":"array","title":"Mobile","description":"Opportunities for mobile devices"},"desktop":{"items":{"$ref":"#/components/schemas/DeviceOpportunity"},"type":"array","title":"Desktop","description":"Opportunities for desktop devices"}},"type":"object","required":["mobile","desktop"],"title":"OpportunitiesByDevice"},"OrganicKeywordSuggestionsConfig":{"properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Id","description":"Location ID (optional)"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Request","description":"Location request (ex: Paris, FR), will translate to location ID"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO3166 country code (ex: GB)"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"BCP47 language code (ex: \"en\", \"en-GB\")"},"device":{"type":"string","enum":["mobile","desktop"],"title":"Device","description":"Device to use for search (optional - defaults to mobile)","default":"mobile"}},"type":"object","title":"OrganicKeywordSuggestionsConfig"},"OrganicKeywordSuggestionsItem":{"properties":{"seed_keyword":{"type":"string","title":"Keyword","description":"Seed Keyword"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country"},"columns":{"items":{"type":"string","enum":["keyword","serp_item_types","results_count","search_volume","cpc","competition","monthly_searches","backlinks_info","main_intent","foreign_intent"]},"type":"array","title":"Columns","description":"Columns to display","default":["keyword","search_volume","competition","cpc","main_intent"]}},"type":"object","required":["seed_keyword"],"title":"OrganicKeywordSuggestionsItem"},"OrganicKeywordSuggestionsProcessedItem":{"properties":{"location_code":{"type":"integer","title":"Location Code","description":"Location code used for the analysis"},"language_code":{"type":"string","title":"Language Code","description":"Language code used for the analysis"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"List of keyword suggestions"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["location_code","language_code","results","status"],"title":"OrganicKeywordSuggestionsProcessedItem"},"OriginEnum":{"type":"string","enum":["site_crawler","real_time_fetch_url","rendering_farm","temporary_upload"],"title":"OriginEnum"},"PageWorkersConfig":{"properties":{},"type":"object","title":"PageWorkersConfig"},"PageWorkersItem":{"properties":{"urls":{"items":{"$ref":"#/components/schemas/URLMetadataUpdate"},"type":"array","title":"URLs","description":"List of URLs and their metadata updates"}},"type":"object","required":["urls"],"title":"PageWorkersItem"},"PageWorkersProcessedItem":{"properties":{"websiteId":{"type":"string","title":"Websiteid","description":"The website ID"},"moduleId":{"type":"string","title":"Moduleid","description":"The PageWorkers module ID"},"urls":{"items":{"$ref":"#/components/schemas/URLMetadataUpdate"},"type":"array","title":"Urls","description":"List of URLs and their metadata updates"},"message":{"type":"string","title":"Message","description":"Message about the operation"},"organization":{"type":"string","title":"Organization","description":"The organization slug"},"project":{"type":"string","title":"Project","description":"The project slug"},"demo":{"type":"boolean","title":"Demo","description":"Whether the operation was run in demo mode"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["websiteId","moduleId","urls","message","organization","project","demo","status"],"title":"PageWorkersProcessedItem"},"PeopleAlsoAskItem":{"properties":{"question":{"type":"string","title":"Question"},"type":{"type":"string","title":"Type"}},"type":"object","required":["question","type"],"title":"PeopleAlsoAskItem"},"PerplexitySearchResult":{"properties":{"url":{"type":"string","title":"Url"},"title":{"type":"string","title":"Title"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["url","title"],"title":"PerplexitySearchResult"},"PrefeedCall":{"properties":{"description":{"type":"string","title":"Description","description":"Description of the prefeed result (used as context label in the prompt)"},"agent":{"type":"string","title":"Agent","description":"Agent ID to call"},"item":{"additionalProperties":true,"type":"object","title":"Item","description":"Item payload for the agent"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Optional config payload for the agent","default":{}}},"type":"object","required":["description","agent","item"],"title":"PrefeedCall","description":"A pre-call to an agent whose result is injected into the user prompt before the LLM runs."},"PreviewAttribute":{"properties":{"key":{"type":"string","title":"Key"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"},"truncated":{"type":"boolean","title":"Truncated"}},"type":"object","required":["key","value","truncated"],"title":"PreviewAttribute"},"PreviewDescriptor":{"properties":{"tag":{"type":"string","title":"Tag"},"first_attributes":{"items":{"$ref":"#/components/schemas/PreviewAttribute"},"type":"array","title":"First Attributes"},"inner_html_excerpt":{"$ref":"#/components/schemas/PreviewExcerpt"},"inner_text_excerpt":{"$ref":"#/components/schemas/PreviewExcerpt"},"has_other_attributes":{"type":"boolean","title":"Has Other Attributes"}},"type":"object","required":["tag","first_attributes","inner_html_excerpt","inner_text_excerpt","has_other_attributes"],"title":"PreviewDescriptor"},"PreviewExcerpt":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"},"truncated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Truncated"}},"type":"object","title":"PreviewExcerpt"},"PreviewOptions":{"properties":{"use_liquid_engine":{"type":"boolean","title":"Use Liquid Engine","description":"Whether or not to use liquid engine","default":false}},"type":"object","title":"PreviewOptions"},"ProjectMetadataConfig":{"properties":{},"type":"object","title":"ProjectMetadataConfig"},"ProjectMetadataItem":{"properties":{"method":{"type":"string","enum":["get","patch"],"title":"Method","description":"Method to execute: 'get' or 'patch'"},"keys":{"items":{"type":"string","enum":["brand_name","website_description","internationalization_strategy","tone_of_voice","currency","revenue_per_visit_desktop","revenue_per_visit_tablet","revenue_per_visit_mobile"]},"type":"array","title":"Keys","description":"The metadata keys to retrieve or store"},"values":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Values","description":"The values to store for given keys, for patch only.It must be the same length as keys and all values must be strings, including numeric ones."}},"type":"object","required":["method","keys"],"title":"ProjectMetadataItem"},"ProjectMetadataProcessedItem":{"properties":{"values":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]},"propertyNames":{"enum":["brand_name","website_description","internationalization_strategy","tone_of_voice","currency","revenue_per_visit_desktop","revenue_per_visit_tablet","revenue_per_visit_mobile"]},"type":"object","title":"Values","description":"Retrieved metadata values"},"not_set_values":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Not Set Values","description":"Keys that were requested but not set"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Message describing the result"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["values","status"],"title":"ProjectMetadataProcessedItem"},"RowsSource":{"properties":{"type":{"type":"string","const":"rows","title":"Type","default":"rows"},"rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","minItems":1,"title":"Rows","description":"The records to process, one object per call."}},"type":"object","required":["rows"],"title":"RowsSource","description":"Records passed directly in the call."},"ScreenshotConfig":{"properties":{},"type":"object","title":"ScreenshotConfig"},"ScreenshotItem":{"properties":{"url":{"type":"string","title":"Url","description":"URL of the page to screenshot"},"css_selector_highlight":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Css Selector Highlight","description":"Optional CSS selector to highlight/focus on a specific element on the page"},"animate":{"type":"boolean","title":"Animate","description":"Generate an animated GIF that zooms into highlighted elements (if CSS selector provided) or scrolls through the page (if no CSS selector)","default":false}},"type":"object","required":["url"],"title":"ScreenshotItem"},"ScreenshotProcessedItem":{"properties":{"screenshot_url":{"type":"string","title":"Screenshot Url","description":"Public URL of the screenshot stored in GCS"},"animated_screenshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Animated Screenshot Url","description":"Public URL of the animated GIF screenshot stored in GCS"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["screenshot_url","status"],"title":"ScreenshotProcessedItem"},"SearchGptConfig":{"properties":{"model":{"type":"string","title":"Model","description":"OpenAI model to use for search","default":"gpt-5-mini"}},"type":"object","title":"SearchGptConfig"},"SearchGptItem":{"properties":{"question":{"type":"string","title":"Question","description":"What would you like to search for?"},"city":{"type":"string","title":"City","description":"The city to search for","default":""},"country":{"type":"string","title":"Country","description":"The country to search for. ISO 3166-1 alpha-2 country code, e.g. \"US\".","default":""}},"type":"object","required":["question"],"title":"SearchGptItem"},"SearchGptLink":{"properties":{"url":{"type":"string","title":"Url"},"title":{"type":"string","title":"Title"},"position":{"type":"integer","title":"Position"}},"type":"object","required":["url","title","position"],"title":"SearchGptLink"},"SearchGptProcessedItem":{"properties":{"model":{"type":"string","title":"Model","description":"Model used for the search"},"answer":{"type":"string","title":"Answer","description":"AI-powered answer to the search query"},"links":{"items":{"$ref":"#/components/schemas/SearchGptLink"},"type":"array","title":"Links","description":"List of source links with titles, URLs and positions"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["model","answer","links","status"],"title":"SearchGptProcessedItem"},"SearchLocation":{"properties":{"code":{"type":"integer","title":"Code"},"name":{"type":"string","title":"Name"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}},"type":"object","required":["code","name"],"title":"SearchLocation"},"SearchSource":{"properties":{"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"rank":{"type":"integer","title":"Rank"},"date_published":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Published"}},"type":"object","required":["url","rank"],"title":"SearchSource","description":"A search result source with snippet and ranking info."},"ShareOfVoiceAnalysisConfig":{"properties":{"domains":{"items":{"type":"string"},"type":"array","title":"Domains","description":"The brand's domains"},"llm_model":{"type":"string","title":"Llm Model","description":"Override LLM model (provider:model_name)","default":"google:gemini-3.1-flash-lite"}},"type":"object","required":["domains"],"title":"ShareOfVoiceAnalysisConfig"},"ShareOfVoiceAnalysisItem":{"properties":{"query":{"type":"string","title":"Query","description":"The search query to analyze"},"text":{"type":"string","title":"Text","description":"The text to analyze"},"links":{"items":{"$ref":"#/components/schemas/Link-Input"},"type":"array","title":"Links","description":"The links to analyze"},"provider_name":{"type":"string","title":"Provider Name","description":"The provider name"}},"type":"object","required":["query","text","links","provider_name"],"title":"ShareOfVoiceAnalysisItem"},"ShareOfVoiceAnalysisProcessedItem":{"properties":{"summary":{"type":"string","title":"Summary","description":"Summary of brand mentions and analysis"},"all_brands_with_sentiment":{"items":{"$ref":"#/components/schemas/BrandMention"},"type":"array","title":"All Brands With Sentiment","description":"List of brands mentioned with their sentiment, rationale, and topics"},"domain_analysis":{"$ref":"#/components/schemas/DomainsAnalysis","description":"Domain analysis"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["summary","all_brands_with_sentiment","domain_analysis","status"],"title":"ShareOfVoiceAnalysisProcessedItem"},"Shopping":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"},"all_images":{"items":{"type":"string"},"type":"array","title":"All Images","default":[]},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating"},"purchasing_options":{"items":{"$ref":"#/components/schemas/ShoppingPurchasingOption"},"type":"array","title":"Purchasing Options","default":[]},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews"},"why_you_might_like_this":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why You Might Like This"},"what_people_are_saying":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"What People Are Saying"},"merchants":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchants","description":"Free-form merchant label as reported by the scraper (e.g. 'Dunelm + others'). Used to render a fallback merchant name when no direct seller URL is available."}},"type":"object","title":"Shopping","description":"A shopping result item."},"ShoppingPurchasingOption":{"properties":{"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency"},"website":{"type":"string","title":"Website"},"buy_link":{"type":"string","title":"Buy Link"}},"type":"object","required":["price","currency","website","buy_link"],"title":"ShoppingPurchasingOption","description":"A purchasing option for a shopping item."},"SinkPointer":{"properties":{"type":{"type":"string","enum":["file","table"],"title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Sink file URL, reusable as the source of a next batch."},"table":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Table","description":"Destination table."},"rows_written":{"type":"integer","title":"Rows Written","description":"Records written.","default":0}},"type":"object","required":["type"],"title":"SinkPointer","description":"Where a batch's output landed."},"SinkSpec":{"oneOf":[{"$ref":"#/components/schemas/FileSink"},{"$ref":"#/components/schemas/TableSink"}],"discriminator":{"propertyName":"type","mapping":{"file":"#/components/schemas/FileSink","table":"#/components/schemas/TableSink"}}},"SiteCrawlerURLDetailsItem":{"properties":{"url":{"type":"string","title":"URL","description":"The URL to analyze"},"question":{"type":"string","title":"Question","description":"What information would you like to know about this URL"}},"type":"object","required":["url","question"],"title":"SiteCrawlerURLDetailsItem"},"SiteCrawlerURLDetailsProcessedItem":{"properties":{"summary":{"type":"string","title":"Summary","description":"A summary of the URL details"},"url_details_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Details Href","description":"A link to the detailed URL analysis in Botify Analytics"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["summary","status"],"title":"SiteCrawlerURLDetailsProcessedItem"},"SourceSpec":{"oneOf":[{"$ref":"#/components/schemas/RowsSource"},{"$ref":"#/components/schemas/SqlSource"},{"$ref":"#/components/schemas/TableSource"},{"$ref":"#/components/schemas/FileSource"}],"discriminator":{"propertyName":"type","mapping":{"file":"#/components/schemas/FileSource","rows":"#/components/schemas/RowsSource","sql":"#/components/schemas/SqlSource","table":"#/components/schemas/TableSource"}}},"SqlSource":{"properties":{"type":{"type":"string","const":"sql","title":"Type","default":"sql"},"query":{"type":"string","title":"Query","description":"BigQuery Standard SQL over catalog tables. Prefix every table with \"catalog.\" (ex: catalog.crawl_pages_20251201). Same access as tables_query."},"limit":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Limit","description":"Stop after this many rows."}},"type":"object","required":["query"],"title":"SqlSource","description":"Rows from a BigQuery query over the project's catalog."},"TableField":{"additionalProperties":true,"type":"object"},"TableSink":{"properties":{"type":{"type":"string","const":"table","title":"Type","default":"table"},"table":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,1023}$","title":"Table","description":"Destination table in the catalog."},"row_map":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Row Map","description":"Column projection, using {{item.}}, {{response.}}, {{error}} and {{row.}}. Defaults to `row`, `item`, `response` and `error` columns."},"replace_existing":{"type":"boolean","title":"Replace Existing","description":"Replace the table instead of appending to it.","default":false}},"type":"object","required":["table"],"title":"TableSink","description":"A table in the project's editable catalog."},"TableSource":{"properties":{"type":{"type":"string","const":"table","title":"Type","default":"table"},"table":{"type":"string","pattern":"^(?:catalog\\.)?[A-Za-z_][A-Za-z0-9_]*$","title":"Table","description":"Table name, with or without the \"catalog.\" prefix."},"limit":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Limit","description":"Stop after this many rows."}},"type":"object","required":["table"],"title":"TableSource","description":"Every row of one catalog table."},"TablesInsertConfig":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Name of the table to insert data into (must be in the editable catalog)"}},"type":"object","required":["table_name"],"title":"TablesInsertConfig"},"TablesInsertItem":{"properties":{"row":{"additionalProperties":true,"type":"object","title":"Row","description":"A single row to insert as a dictionary"}},"type":"object","required":["row"],"title":"TablesInsertItem"},"TablesInsertProcessedItem":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Name of the table"},"rows_inserted":{"type":"integer","title":"Rows Inserted","description":"Number of rows inserted"},"errors":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Errors","description":"Any errors that occurred during insertion"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["table_name","rows_inserted","errors","status"],"title":"TablesInsertProcessedItem"},"TablesLoadConfig":{"properties":{},"type":"object","title":"TablesLoadConfig"},"TablesLoadItem":{"properties":{"table_name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,1023}$","title":"Table Name","description":"Destination table name in the editable catalog; must not match a managed table family"},"table_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Table Description","description":"Optional BigQuery table description"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"HTTP(S) URL of the source file. Temporary uploaded URLs on https://app.botify.com/:organization/:project/o/storage/tmp are allowed."},"content_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Base64","description":"Base64-encoded file content. Prefer source_url for large files."},"format":{"$ref":"#/components/schemas/DelimitedFormat","description":"Delimited input format, or auto-detect from the filename","default":"auto"},"columns":{"anyOf":[{"items":{"$ref":"#/components/schemas/ColumnDefinition"},"type":"array"},{"type":"null"}],"title":"Columns","description":"Optional explicit BigQuery schema. When omitted, BigQuery infers the schema from the file header and rows."},"replace_existing":{"type":"boolean","title":"Replace Existing","description":"Replace an existing table. Disabled by default to prevent unintentional data loss.","default":false}},"type":"object","required":["table_name"],"title":"TablesLoadItem","description":"A delimited file and metadata for a new BigQuery table."},"TablesLoadProcessedItem":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Created or loaded table name"},"rows_loaded":{"type":"integer","title":"Rows Loaded","description":"Number of rows loaded"},"format":{"type":"string","title":"Format","description":"Detected file format"},"replaced_existing":{"type":"boolean","title":"Replaced Existing","description":"Whether an existing table was replaced"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["table_name","rows_loaded","format","replaced_existing","status"],"title":"TablesLoadProcessedItem"},"TablesQueryConfig":{"properties":{},"type":"object","title":"TablesQueryConfig"},"TablesQueryItem":{"properties":{"query":{"type":"string","title":"Query","description":"BigQuery SQL query to execute"},"max_results":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Max Results","description":"Maximum number of results to return","default":10000}},"type":"object","required":["query"],"title":"TablesQueryItem"},"TablesQueryProcessedItem":{"properties":{"fields":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Fields","description":"Field definitions with name and type"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"Query execution results as list of lists"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["fields","results","status"],"title":"TablesQueryProcessedItem"},"TablesSchemaConfig":{"properties":{},"type":"object","title":"TablesSchemaConfig"},"TablesSchemaItem":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Name of the table to get schema for. Wildcard not allowed."}},"type":"object","required":["table_name"],"title":"TablesSchemaItem"},"TablesSchemaProcessedItem":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Name of the table"},"fields":{"items":{"$ref":"#/components/schemas/TableField"},"type":"array","title":"Fields","description":"List of field definitions with name, type, and enum values when known"},"found":{"type":"boolean","title":"Found","description":"Whether the table was found in the available tables"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["table_name","fields","found","status"],"title":"TablesSchemaProcessedItem"},"TablesTextToSqlConfig":{"properties":{"reasoning_effort":{"type":"string","enum":["low","high"],"title":"Reasoning Effort","description":"Thinking level for the LLM: 'low' for simple queries, 'high' for complex ones","default":"low"},"run_query":{"type":"boolean","title":"Run Query","description":"If true, execute the generated query and return results. If false, only return the generated SQL.","default":true},"allow_empty_results":{"type":"boolean","title":"Allow Empty Results","description":"If true, a query returning zero rows is a valid answer. Set it to false in workflows, so the node fails (and retries) instead of passing empty data to the downstream nodes.","default":true}},"type":"object","title":"TablesTextToSqlConfig"},"TablesTextToSqlItem":{"properties":{"text_query":{"type":"string","title":"Text Query","description":"Natural language description of the data you want to query. Avoid writing SQL syntax."},"max_rows":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Rows","description":"Maximum number of rows to return. Enforces a LIMIT in the SQL and caps results at the API level."},"output_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Output Fields","description":"Optional. Restrict the query output to exactly these column names and no others. Keeps downstream steps stable while the agent stays agnostic. Other columns may still be used in WHERE/ORDER BY/GROUP BY."}},"type":"object","required":["text_query"],"title":"TablesTextToSqlItem"},"TablesTextToSqlProcessedItem":{"properties":{"query":{"type":"string","title":"Query","description":"The generated BigQuery SQL query"},"fields":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Fields","description":"Field definitions with name and type (empty if run_query=false)"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"Query execution results (empty if run_query=false)"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["query","fields","results","status"],"title":"TablesTextToSqlProcessedItem"},"TemplateGeneratorConfig":{"properties":{},"type":"object","title":"TemplateGeneratorConfig"},"TemplateGeneratorItem":{"properties":{"url":{"type":"string","title":"Example URL","description":"An example URL of the page to generate the template for."},"template_engine":{"type":"string","enum":["nunjucks","liquid"],"title":"Template Engine","description":"Template engine to target (nunjucks or liquid)","default":"nunjucks"},"element_type":{"type":"string","enum":["title","description","h1","canonical","customHtml"],"title":"Element type","description":"Type of element for which to generate the template. Can be one of: title, description, h1, canonical or customHtml.","default":"customHtml"},"variables_description":{"type":"string","format":"textarea","title":"Variables Description","description":"Describe the available variables and their structure."},"template_requirements":{"type":"string","format":"textarea","title":"Template Requirements","description":"Describe what you want to generate in the template."}},"type":"object","required":["url","variables_description","template_requirements"],"title":"TemplateGeneratorItem"},"TemplateGeneratorProcessedItem":{"properties":{"template":{"type":"string","title":"Template","description":"The template code"},"explanation":{"type":"string","title":"Explanation","description":"A brief explanation of the template"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["template","explanation","status"],"title":"TemplateGeneratorProcessedItem"},"TemplatePreview":{"properties":{"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","title":"TemplatePreview"},"TmpUploadResponse":{"properties":{"link":{"type":"string","title":"Link"},"upload_id":{"type":"string","title":"Upload Id"},"full_path":{"type":"string","title":"Full Path"}},"type":"object","required":["link","upload_id","full_path"],"title":"TmpUploadResponse"},"TopicPage":{"properties":{"url":{"type":"string","title":"Url","description":"URL of the page."},"title":{"type":"string","title":"Title","description":"Title of the page."},"description":{"type":"string","title":"Description","description":"Description of the page."},"relevance_score":{"type":"number","title":"Relevance Score","description":"Relevance score."},"explanation":{"type":"string","title":"Explanation","description":"Explanation of the relevance score."}},"type":"object","required":["url","title","description","relevance_score","explanation"],"title":"TopicPage"},"URLKeywordsConfig":{"properties":{},"type":"object","title":"URLKeywordsConfig"},"URLKeywordsItem":{"properties":{"url":{"type":"string","title":"Url","description":"The URL to analyze."},"period":{"type":"string","enum":["last_7d","last_30d","last_90d"],"title":"Time Period","description":"Time period to analyze."}},"type":"object","required":["url","period"],"title":"URLKeywordsItem"},"URLKeywordsProcessedItem":{"properties":{"project_metadata":{"$ref":"#/components/schemas/ProjectMetadataProcessedItem","description":"Project metadata information."},"period":{"type":"string","title":"Period","description":"The time period analyzed."},"keywords":{"items":{"$ref":"#/components/schemas/KeywordPerformance"},"type":"array","title":"Keywords","description":"List of keyword performance metrics."},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics","description":"Top-level metrics for the URL."},"estimated_revenue":{"type":"number","title":"Estimated Revenue","description":"Estimated revenue based on keyword performance."},"estimated_revenue_currency":{"type":"string","title":"Estimated Revenue Currency","description":"Currency of the estimated revenue."},"predictions_agg":{"additionalProperties":{"additionalProperties":{"type":"number"},"type":"object"},"type":"object","title":"Predictions Agg","description":"Aggregated predictions for different devices."},"estimated_revenue_comments":{"type":"string","title":"Estimated Revenue Comments","description":"Comments on how the estimated revenue was calculated."},"keywords_comments":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywords Comments","description":"Comments on the keyword performance metrics provided."},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["project_metadata","period","keywords","metrics","estimated_revenue","estimated_revenue_currency","predictions_agg","estimated_revenue_comments","status"],"title":"URLKeywordsProcessedItem"},"URLMetadataUpdate":{"properties":{"url":{"type":"string","title":"Url","description":"Specific URL to update (wildcards like '*' are not allowed)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"New title to set for the page"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"New description to set for the page"},"h1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"H1","description":"New H1 to set for the page"},"custom_changes":{"items":{"$ref":"#/components/schemas/CustomChange"},"type":"array","maxItems":10,"title":"Custom Changes","description":"List of custom changes to apply to specific elements on the page","default":[]}},"type":"object","required":["url"],"title":"URLMetadataUpdate","description":"Metadata updates to apply to a specific URL."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WorkflowRunCancelRequest":{"properties":{"execution_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Execution Id","description":"Cloud Run execution id. Omitted for build-mode runs, which have no Cloud Run execution and are stopped via the status store only. Must be non-empty when provided (job mode).","examples":["staging-organic-search-lab-agents-workflow-runner-sandbox5vq4se"]}},"type":"object","title":"WorkflowRunCancelRequest","description":"Request to cancel a workflow run."},"WorkflowRunCancelResponse":{"properties":{"run_id":{"type":"string","title":"Run Id","description":"Workflow run ID"},"execution_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Name","description":"Cloud Run execution resource name (None for build mode)"},"operation_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operation Name","description":"Cloud Run cancel operation name (None for build mode)"},"status":{"type":"string","const":"cancelled","title":"Status","description":"Workflow status after cancel request","default":"cancelled"}},"type":"object","required":["run_id"],"title":"WorkflowRunCancelResponse","description":"Response from cancelling a workflow run."},"WorkflowStatus":{"properties":{"run_id":{"type":"string","title":"Run Id","description":"Unique ID of the workflow run"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled"],"title":"Status","description":"Current status of the workflow"},"workflow_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Name","description":"Name of the workflow"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"ISO timestamp when workflow started"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"ISO timestamp when workflow completed"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if failed"},"failed_node_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed Node Id","description":"Node ID where the workflow failed"},"nodes_stats":{"items":{"$ref":"#/components/schemas/NodeStats"},"type":"array","title":"Nodes Stats","description":"Statistics for each node"}},"type":"object","required":["run_id","status"],"title":"WorkflowStatus","description":"Status of a workflow run."},"WorkflowStatusSummary":{"properties":{"run_id":{"type":"string","title":"Run Id","description":"Unique ID of the workflow run"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled"],"title":"Status","description":"Current status of the workflow"},"workflow_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Name","description":"Name of the workflow"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"ISO timestamp when workflow started"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"ISO timestamp when workflow completed"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if failed"},"failed_node_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed Node Id","description":"Node ID where the workflow failed"},"nodes_stats":{"items":{"$ref":"#/components/schemas/NodeStatsSummary"},"type":"array","title":"Nodes Stats","description":"Summary statistics for each node"}},"type":"object","required":["run_id","status"],"title":"WorkflowStatusSummary","description":"Lightweight workflow status with counters only and last task per node.\n\nThis avoids transferring potentially megabytes of task details when only\nprogress counters are needed."},"dinosaur__agents__agents__perplexity__agent__PerplexityConfig":{"properties":{"model":{"type":"string","title":"Model","description":"Perplexity model to use","default":"sonar"},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"Temperature for the Perplexity model","default":0.3}},"type":"object","title":"PerplexityConfig"},"dinosaur__agents__agents__perplexity__agent__PerplexityItem":{"properties":{"question":{"type":"string","minLength":1,"title":"Question","description":"The question you want to ask Perplexity"}},"type":"object","required":["question"],"title":"PerplexityItem"},"dinosaur__agents__agents__perplexity__agent__PerplexityProcessedItem":{"properties":{"answer":{"type":"string","title":"Answer","description":"The answer from Perplexity"},"citations":{"items":{"type":"string"},"type":"array","title":"Citations","description":"List of citation URLs"},"search_results":{"items":{"$ref":"#/components/schemas/PerplexitySearchResult"},"type":"array","title":"Search Results","description":"List of search results used to generate the answer"},"related_questions":{"items":{"type":"string"},"type":"array","title":"Related Questions","description":"List of related questions"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Name / version of the model used"},"status":{"type":"string","const":"success","title":"Status","readOnly":true}},"type":"object","required":["answer","citations","search_results","related_questions","status"],"title":"PerplexityProcessedItem"},"dinosaur__agents__common__chatgpt_websearch_entities__Citation":{"properties":{"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"cited":{"type":"boolean","title":"Cited"}},"type":"object","required":["url","cited"],"title":"Citation","description":"A source cited in the response with metadata."},"dinosaur__agents__common__chatgpt_websearch_entities__Link":{"properties":{"url":{"type":"string","title":"Url"},"text":{"type":"string","title":"Text"},"position":{"type":"integer","title":"Position"}},"type":"object","required":["url","text","position"],"title":"Link","description":"An inline citation link extracted from the answer."}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"tags":[{"name":"Action Board","description":"Retrieve actions from ActionBoard for your projects."},{"name":"Agentic Catalog Sources","description":"List the AgenticCatalog sources of a project"},{"name":"AI Gateway","description":"Generate structured output from text input"},{"name":"Batch Run","description":"Run any other tool over many records, from a list, a SQL query, a table or an uploaded CSV, and collect the results in a file or a table."},{"name":"Botify Config","description":"Get Botify product configurations (SpeedWorkers, PageWorkers, Botify Core)"},{"name":"Botify Data","description":"Query your Botify data."},{"name":"Calculator","description":"Perform basic arithmetic operations."},{"name":"Chatgpt Websearch","description":"Call ChatGPT.com using web search tool to get real-time responses and information."},{"name":"Embed","description":"Generate embeddings from text"},{"name":"Credit Consumption","description":"Report how much of this project's agent credit allowance is used, daily and monthly."},{"name":"Google Ads Keyword Suggestions","description":"Get keyword suggestions from Google Ads Keywords Planner."},{"name":"Google Ads Search Volume","description":"Fetches Google Ads search volume data for keywords."},{"name":"Google AI Mode","description":"Query Google AI Mode to get AI-generated search results and insights."},{"name":"Google Ai Overview","description":"Query Google AI Overview to get an AI-generated summary from a query."},{"name":"Google Gemini","description":"Query Google Gemini to get AI-generated search results and insights."},{"name":"Google Knowledge Graph","description":"Search Google Knowledge Graph for entities about people, places, and things."},{"name":"Google People Also Ask","description":"Retrieve Google 'People Also Ask' questions for a specific query."},{"name":"Google People Also Search","description":"Retrieve the Google 'People Also Search' questions for a specific query"},{"name":"Google Position-based Click Opportunities","description":"Analyze potential click gains from ranking position improvements."},{"name":"Google Search","description":"Ask a question about Google Search results"},{"name":"Google SERP","description":"Fetch the Google SERP for a given query (returns all data)"},{"name":"Google Trends","description":"Get Google Trends data for one or more keywords."},{"name":"Google URL Inspection","description":"Get Google URL Inspection data for a specific URL."},{"name":"HTML Executor","description":"Execute a JavaScript function on HTML from SiteCrawler crawls."},{"name":"HTML Extract Images","description":"Extract main images from a webpage with URLs and copyright info."},{"name":"HTML Extractor through CSS Selector","description":"Generate a CSS selector to extract data from a given HTML page."},{"name":"HTML Fetch","description":"Get the HTML of a given URL."},{"name":"HTML Grep","description":"Search expressions in a page HTML and return surrounding context."},{"name":"HTML Lang","description":"Get the language of a given HTML page (BCP47 format)"},{"name":"HTML PageWorkers Preview","description":"Preview PageWorkers."},{"name":"HTML Question","description":"Ask any question about an HTML Page."},{"name":"HTML Structured Data","description":"Extract structured data (JSON-LD) from HTML pages."},{"name":"HTML To Text","description":"Extract text from a given HTML page"},{"name":"Keywords Clustering","description":"Cluster keywords into groups."},{"name":"Keywords Extractor","description":"Extract top X keywords from given URLs"},{"name":"Keyword Suggestions","description":"Get organic keyword suggestions from a given keyword."},{"name":"Keywords Suggestions From Google Ads Planner","description":"Get keyword suggestions from Google Ads Keywords Planner."},{"name":"Knowledge","description":"Find answers to how to use Botify."},{"name":"List Annotations","description":"Retrieve annotations logged on your project."},{"name":"Find Nearest Pages for Topic","description":"Get the nearest page for a given topic."},{"name":"Organic Keyword Suggestions","description":"Get organic keyword suggestions from a given keyword."},{"name":"PageWorkers Generic URLs Actions","description":"Update metadata or apply custom changes to URLs (PageWorkers)."},{"name":"Perplexity","description":"Ask a question to Perplexity."},{"name":"Project Memory","description":"Get or patch information about the project (tone of voice, website description...)"},{"name":"Screenshot","description":"Capture a screenshot of a webpage and return a URL for the screenshot and an optional animated GIF"},{"name":"SearchGPT","description":"Search the web and get AI-powered answers with citations."},{"name":"Share Of Voice Analysis","description":"Analyze the share of voice (no brand config required)"},{"name":"URL Details from Botify SiteCrawler","description":"Find crawl data for a given URL."},{"name":"Tables Insert","description":"Agent that inserts data into a BigQuery table in the customer's editable catalog dataset"},{"name":"Tables Load","description":"Load a CSV or TSV file into the current project's editable BigQuery catalog"},{"name":"Tables Query","description":"Query any table in the data model with BigQuery Standard SQL syntax. Always prefix tables with \"catalog.\" (ex: catalog.crawl_pages_20251201)."},{"name":"Tables Schema","description":"Agent that retrieves the schema (field names and types) for a given table"},{"name":"Tables Text To Sql","description":"Convert natural language to SQL queries"},{"name":"Template Generator","description":"Generate a template based on HTML structure and available variables."},{"name":"Keywords performance for URL (From Google Search Console)","description":"Get GSC keywords for a given URL."}],"security":[{"BearerAuth":[]}]}