{"openapi":"3.1.0","info":{"title":"Document360 Analytics (BYOK) API","version":"0.1.0","description":"Document360 Analytics (BYOK) lets an AI assistant read your own Document360 Analytics data through the Document360 Analytics API with a key you supply (Document360 API v3 key (Settings > Knowledge base portal > API keys)). Read-only: 12 tools (list_projects, list_workspaces, get_article_analytics_summary, get_top_articles, get_top_categories, get_most_read_articles, get_visits_by_country,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-document360-analytics.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-document360-analytics/docs"},"termsOfService":"https://connectorbay.com/byok-document360-analytics/terms"},"servers":[{"url":"https://byok-document360-analytics.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-document360-analytics/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_projects":{"post":{"operationId":"list_projects","summary":"List the Document360 projects the key can see, with name, sub-domain, status and dates (default data center). Use for \"W","description":"List the Document360 projects the key can see, with name, sub-domain, status and dates (default data center). Use for \"Which Document360 projects can my key see\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"}},"title":"list_projectsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_workspaces":{"post":{"operationId":"list_workspaces","summary":"List the workspaces of a project with name, slug, order, default flag and type. Use for \"Which workspaces does my Docume","description":"List the workspaces of a project with name, slug, order, default flag and type. Use for \"Which workspaces does my Document360 project have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"}},"required":["project_id"],"title":"list_workspacesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_article_analytics_summary":{"post":{"operationId":"get_article_analytics_summary","summary":"Needs the premium API add-on of the project. Get totals for a date range: views, reads, likes, dislikes, the most common","description":"Needs the premium API add-on of the project. Get totals for a date range: views, reads, likes, dislikes, the most common reading duration and the number of articles. Use for \"How many views did my Document360 articles get last month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_article_analytics_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_top_articles":{"post":{"operationId":"get_top_articles","summary":"Needs the premium API add-on of the project. List articles ranked by views, reads, likes or dislikes, with time spent, f","description":"Needs the premium API add-on of the project. List articles ranked by views, reads, likes or dislikes, with time spent, feedback count and last viewed time. Use for \"Which Document360 articles are viewed the most\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"sort_by":{"anyOf":[{"enum":["views","reads","likes","dislikes"],"type":"string"},{"type":"null"}],"default":"views","description":"Column to sort by: views, reads, likes, dislikes.","title":"Sort By"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction: asc or desc.","title":"Sort Order"}},"required":["project_id"],"title":"get_top_articlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_top_categories":{"post":{"operationId":"get_top_categories","summary":"Needs the premium API add-on of the project. List categories ranked by views, reads, likes or dislikes with their articl","description":"Needs the premium API add-on of the project. List categories ranked by views, reads, likes or dislikes with their article counts. Use for \"Which Document360 categories get the most reads\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"sort_by":{"anyOf":[{"enum":["views","reads","likes","dislikes"],"type":"string"},{"type":"null"}],"default":"views","description":"Column to sort by: views, reads, likes, dislikes.","title":"Sort By"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction: asc or desc.","title":"Sort Order"}},"required":["project_id"],"title":"get_top_categoriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_most_read_articles":{"post":{"operationId":"get_most_read_articles","summary":"Needs the premium API add-on of the project. List the articles readers spend the longest with, with reading duration in ","description":"Needs the premium API add-on of the project. List the articles readers spend the longest with, with reading duration in seconds. Use for \"Which Document360 articles are read the longest\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_most_read_articlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_visits_by_country":{"post":{"operationId":"get_visits_by_country","summary":"Needs the premium API add-on of the project. Get article visits per country (ISO country code) for a date range. Use for","description":"Needs the premium API add-on of the project. Get article visits per country (ISO country code) for a date range. Use for \"Which countries visit my Document360 site most\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_visits_by_countryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_search_summary":{"post":{"operationId":"get_search_summary","summary":"Needs the premium API add-on of the project. Get search totals for a date range: searches, successful, no-result and bou","description":"Needs the premium API add-on of the project. Get search totals for a date range: searches, successful, no-result and bounced searches, and success and failure rates. Use for \"How successful are searches on my Document360 site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_search_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_top_search_keywords":{"post":{"operationId":"get_top_search_keywords","summary":"Needs the premium API add-on of the project. List the search phrases readers use most, with search, view, read and bounc","description":"Needs the premium API add-on of the project. List the search phrases readers use most, with search, view, read and bounce counts. Use for \"What do readers search for most on my Document360 site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"sort_by":{"anyOf":[{"enum":["count","viewed","read","bounced"],"type":"string"},{"type":"null"}],"default":"count","description":"Column to sort by: count, viewed, read, bounced.","title":"Sort By"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction: asc or desc.","title":"Sort Order"},"search_text":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only keywords containing this text.","title":"Search Text"}},"required":["project_id"],"title":"get_top_search_keywordsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_no_result_keywords":{"post":{"operationId":"get_no_result_keywords","summary":"Needs the premium API add-on of the project. List search phrases that returned no results, with counts, to find missing ","description":"Needs the premium API add-on of the project. List search phrases that returned no results, with counts, to find missing content. Use for \"Which searches return nothing on my Document360 site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"sort_by":{"anyOf":[{"enum":["count","viewed","read","bounced"],"type":"string"},{"type":"null"}],"default":"count","description":"Column to sort by: count, viewed, read, bounced.","title":"Sort By"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction: asc or desc.","title":"Sort Order"},"search_text":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only keywords containing this text.","title":"Search Text"}},"required":["project_id"],"title":"get_no_result_keywordsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_feedback_summary":{"post":{"operationId":"get_feedback_summary","summary":"Needs the premium API add-on of the project. Get reader feedback totals for a date range: likes, dislikes, feedback coun","description":"Needs the premium API add-on of the project. Get reader feedback totals for a date range: likes, dislikes, feedback count and the reasons readers gave (more information needed, hard to understand, irrelevant, broken link, other). Use for \"How is reader feedback on my Document360 articles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_feedback_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_trending_topics":{"post":{"operationId":"get_trending_topics","summary":"Needs the premium API add-on of the project. List topics readers ask about in AI search, with question counts and whethe","description":"Needs the premium API add-on of the project. List topics readers ask about in AI search, with question counts and whether a topic is a cluster of unanswered questions. Use for \"What topics are trending in AI search on my Document360 site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Document360 project id (from list_projects).","maxLength":60,"title":"Project Id","type":"string"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the date range (inclusive), ISO 8601, for example 2026-01-01.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the date range (inclusive), ISO 8601, for example 2026-01-31.","title":"End Date"},"workspace_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workspace (id from list_workspaces).","title":"Workspace Id"},"lang_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code such as en or fr; the project's main language when omitted.","title":"Lang Code"}},"required":["project_id"],"title":"get_trending_topicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}