{ "openapi": "3.0.0", "info": { "title": "AIshark Marketing Platform API", "description": "Access 50+ marketing, analytics, SEO, social media, and sales tools through a unified API. Includes Google Analytics 4, Search Console, Facebook, LinkedIn, Instagram, Twitter, TikTok, YouTube, Google Ads, Meta Ads, WordPress, email campaigns, and more.", "version": "1.0.0", "contact": { "name": "AIshark Support", "url": "https:\/\/sharksapi.ai" } }, "servers": [ { "url": "https:\/\/sharksapi.ai\/api", "description": "Production server" } ], "security": [ { "bearerAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Laravel Sanctum API token with project access (project_id:X ability)" } }, "schemas": [] }, "paths": { "\/openapi\/tools\/get_analytics_summary": { "post": { "summary": "Get a dashboard overview of all connected marketing platforms (GA4, Search Console, Facebook, LinkedIn, Twitter, Google Ads, Meta Ads) with their connection status, property IDs, and configuration. Use this first to understand which analytics sources are available before fetching specific data.", "description": "Get a dashboard overview of all connected marketing platforms (GA4, Search Console, Facebook, LinkedIn, Twitter, Google Ads, Meta Ads) with their connection status, property IDs, and configuration. Use this first to understand which analytics sources are available before fetching specific data.", "operationId": "get_analytics_summary", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4": { "post": { "summary": "Fetch website traffic data from Google Analytics 4 for a date range. Returns daily or aggregated metrics: total users, new users, sessions, pageviews, bounce rate, average session duration, and engagement rate. Use aggregate=true for a single summary row (faster). Ideal for answering \"how much traffic did we get?\" or \"what are our website stats?\" For metric_card dashboard widgets pass metric=sessions|users|pageviews|bounce_rate|avg_session_duration|engagement_rate to get a single aggregated value for that field.", "description": "Fetch website traffic data from Google Analytics 4 for a date range. Returns daily or aggregated metrics: total users, new users, sessions, pageviews, bounce rate, average session duration, and engagement rate. Use aggregate=true for a single summary row (faster). Ideal for answering \"how much traffic did we get?\" or \"what are our website stats?\" For metric_card dashboard widgets pass metric=sessions|users|pageviews|bounce_rate|avg_session_duration|engagement_rate to get a single aggregated value for that field.", "operationId": "get_ga4", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD)" }, "end_date": { "type": "string", "format": "date", "description": "End date (YYYY-MM-DD)" }, "aggregate": { "type": "boolean", "default": false, "description": "Return single aggregated row" }, "metric": { "type": "string", "description": "Optional. When set, return only this metric field. Use for metric_card widgets. Valid values: sessions, users, pageviews, bounce_rate, avg_session_duration, engagement_rate" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4_channels": { "post": { "summary": "Break down website traffic by acquisition channel from GA4: sessions, users, pageviews, bounce rate, avg session duration, key_events (total conversions) and conversion_rate (key events \/ sessions, fraction 0\u20131) per channel \u2014 Organic Search, Direct, Social, Referral, Paid Search, Cross-network, Email, Display. Pass key_events=[\"generate_lead\",\"click_to_call\"] to add one column per named key event (find the names with get_ga4_events key_events_only=true). Use this to answer \"where does our traffic come from?\" or \"which channel actually converts?\"", "description": "Break down website traffic by acquisition channel from GA4: sessions, users, pageviews, bounce rate, avg session duration, key_events (total conversions) and conversion_rate (key events \/ sessions, fraction 0\u20131) per channel \u2014 Organic Search, Direct, Social, Referral, Paid Search, Cross-network, Email, Display. Pass key_events=[\"generate_lead\",\"click_to_call\"] to add one column per named key event (find the names with get_ga4_events key_events_only=true). Use this to answer \"where does our traffic come from?\" or \"which channel actually converts?\"", "operationId": "get_ga4_channels", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "key_events": { "type": "array", "items": { "type": "string" }, "description": "GA4 key-event names to add as per-channel columns, e.g. [\"generate_lead\", \"click_to_call\", \"kirjuta_meile\"]. Total key_events is always included." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4_pages": { "post": { "summary": "Get the top website pages from GA4 ranked by pageviews, with page title, path, pageviews and sessions. Use this for \"top pages\", \"which pages got traffic?\", or when a dashboard needs page-level GA4 rows.", "description": "Get the top website pages from GA4 ranked by pageviews, with page title, path, pageviews and sessions. Use this for \"top pages\", \"which pages got traffic?\", or when a dashboard needs page-level GA4 rows.", "operationId": "get_ga4_pages", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4_landing_pages": { "post": { "summary": "Compatibility alias for page-level GA4 traffic. Returns the same page title\/path, pageviews and sessions fields as get_ga4_pages; use get_gsc_top_pages when you specifically need organic-search landing pages from Search Console.", "description": "Compatibility alias for page-level GA4 traffic. Returns the same page title\/path, pageviews and sessions fields as get_ga4_pages; use get_gsc_top_pages when you specifically need organic-search landing pages from Search Console.", "operationId": "get_ga4_landing_pages", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_search_console": { "post": { "summary": "Fetch Google organic search performance data from Search Console. Returns daily clicks, impressions, click-through rate (CTR), and average position in Google search results. Use aggregate=true for totals. Ideal for answering \"how do we perform in Google search?\" or \"is our SEO improving?\" For metric_card dashboard widgets pass metric=clicks|impressions|ctr|position to get a single aggregated value for that field.", "description": "Fetch Google organic search performance data from Search Console. Returns daily clicks, impressions, click-through rate (CTR), and average position in Google search results. Use aggregate=true for totals. Ideal for answering \"how do we perform in Google search?\" or \"is our SEO improving?\" For metric_card dashboard widgets pass metric=clicks|impressions|ctr|position to get a single aggregated value for that field.", "operationId": "get_search_console", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD, today, yesterday, or NdaysAgo such as 30daysAgo). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date", "description": "End date (YYYY-MM-DD, today, yesterday, or NdaysAgo)." }, "aggregate": { "type": "boolean", "default": false }, "metric": { "type": "string", "description": "Optional. When set, return only this metric field. Use for metric_card widgets. Valid values: clicks, impressions, ctr, position" }, "dimensions": { "type": "array", "items": { "type": "string" }, "description": "NOT supported here \u2014 this tool returns daily totals. For a breakdown by search term use get_gsc_top_queries, by URL use get_gsc_top_pages." }, "row_limit": { "type": "integer", "description": "NOT supported here \u2014 use get_gsc_top_queries \/ get_gsc_top_pages with `limit`." }, "country": { "type": "string", "description": "NOT supported here \u2014 use get_gsc_top_queries with country (ISO-3166 alpha-3, e.g. est) for market-filtered query data." }, "page": { "type": "string", "description": "NOT supported here \u2014 use get_gsc_top_pages, or get_gsc_top_queries with page when you need query data filtered to one URL\/section." }, "limit": { "type": "integer", "description": "NOT supported here \u2014 this tool returns daily totals. Use get_gsc_top_queries \/ get_gsc_top_pages with limit for ranked breakdown rows." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gsc_top_pages": { "post": { "summary": "Get the best-performing website pages in Google search ranked by clicks. Returns URL, clicks, impressions, CTR, and average position for each page. Use this to find \"which pages bring the most organic traffic?\" or \"what are our strongest landing pages?\"", "description": "Get the best-performing website pages in Google search ranked by clicks. Returns URL, clicks, impressions, CTR, and average position for each page. Use this to find \"which pages bring the most organic traffic?\" or \"what are our strongest landing pages?\"", "operationId": "get_gsc_top_pages", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 }, "query": { "type": "string", "description": "Optional search-query substring filter. Use this when you need pages that ranked for a specific term." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gsc_top_queries": { "post": { "summary": "Get the top Google search queries that bring visitors to the website. Returns keyword, clicks, impressions, CTR, and average position. Use this to answer \"what keywords do we rank for?\" or \"which search terms drive traffic?\" Essential for SEO keyword strategy. Filter by country (ISO-3166 alpha-3, e.g. \"fin\" for Finland, \"est\" for Estonia) to see per-market keywords, and\/or by page (substring, e.g. \"\/fi\/\") to scope to one section.", "description": "Get the top Google search queries that bring visitors to the website. Returns keyword, clicks, impressions, CTR, and average position. Use this to answer \"what keywords do we rank for?\" or \"which search terms drive traffic?\" Essential for SEO keyword strategy. Filter by country (ISO-3166 alpha-3, e.g. \"fin\" for Finland, \"est\" for Estonia) to see per-market keywords, and\/or by page (substring, e.g. \"\/fi\/\") to scope to one section.", "operationId": "get_gsc_top_queries", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 }, "country": { "type": "string", "description": "ISO-3166-1 alpha-3 country code, e.g. \"fin\", \"est\", \"swe\", \"nor\"." }, "page": { "type": "string", "description": "Only queries for pages whose URL contains this substring, e.g. \"\/fi\/\"." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gsc_keyword_positions": { "post": { "summary": "Daily Google ranking position of a fixed set of search terms from Search Console \u2014 the data source for a \"SEO positsioonid\" rank-trend chart. Pass keywords (exact search terms, e.g. [\"soojuspump\",\"maak\u00fcte\"]); when omitted the tracked keyword list from the connected SeoShark project is used (top_n of them), and as a last resort the top queries by clicks. Returns one row per day: {date, \"\": position|null, ...} \u2014 null = no impressions that day (a gap, not rank 0). Position is the GSC daily average for the EXACT term (case-insensitive), so it is stable and comparable month to month. Use for chart_line widgets with display_config.y_axis.reverse=true; pass summary=true for a table of current positions (last 7 days vs previous 7). Note GSC data lags ~2 days. Filter by country (alpha-3, e.g. \"est\") to see one market.", "description": "Daily Google ranking position of a fixed set of search terms from Search Console \u2014 the data source for a \"SEO positsioonid\" rank-trend chart. Pass keywords (exact search terms, e.g. [\"soojuspump\",\"maak\u00fcte\"]); when omitted the tracked keyword list from the connected SeoShark project is used (top_n of them), and as a last resort the top queries by clicks. Returns one row per day: {date, \"\": position|null, ...} \u2014 null = no impressions that day (a gap, not rank 0). Position is the GSC daily average for the EXACT term (case-insensitive), so it is stable and comparable month to month. Use for chart_line widgets with display_config.y_axis.reverse=true; pass summary=true for a table of current positions (last 7 days vs previous 7). Note GSC data lags ~2 days. Filter by country (alpha-3, e.g. \"est\") to see one market.", "operationId": "get_gsc_keyword_positions", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Exact search terms to track (max 20). Omit to use the SeoShark tracked keyword list." }, "top_n": { "type": "integer", "default": 6, "description": "How many tracked keywords to auto-select when keywords is omitted (best current SeoShark position first)." }, "days": { "type": "integer", "default": 30, "description": "Lookback window in days (used when start_date\/end_date are omitted)." }, "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 30 days." }, "end_date": { "type": "string", "format": "date" }, "country": { "type": "string", "description": "ISO-3166-1 alpha-3 country code, e.g. \"est\", \"fin\"." }, "page": { "type": "string", "description": "Only count rankings of pages whose URL contains this substring." }, "summary": { "type": "boolean", "default": false, "description": "Return one row per keyword instead of daily rows: {keyword, position (impression-weighted avg of the last 7 reported days), previous_position (the 7 days before), change (+ = improved), clicks_7d, impressions_7d, days_seen_7d}. Use for a \"hetkeseis\" table widget next to the rank-trend chart." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4_events": { "post": { "summary": "Get all GA4 events with their counts and user numbers for a date range. Returns event_name, event_count, users. Shows what actions visitors take on the site (page_view, click, scroll, form_submit, purchase, etc). Use limit to control how many events. Set key_events_only=true to see only conversion\/key events.", "description": "Get all GA4 events with their counts and user numbers for a date range. Returns event_name, event_count, users. Shows what actions visitors take on the site (page_view, click, scroll, form_submit, purchase, etc). Use limit to control how many events. Set key_events_only=true to see only conversion\/key events.", "operationId": "get_ga4_events", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "key_events_only": { "type": "boolean", "default": false, "description": "Only show key events (conversions)" }, "limit": { "type": "integer", "default": 20 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_business_reviews": { "post": { "summary": "Fetch Google Business Profile reviews \u2014 rating, reviewer name, comment text, reply status. Returns the most recent reviews. Use to answer \"what do customers say about us?\" or \"what is our Google rating?\" 90% of customers check reviews before buying.", "description": "Fetch Google Business Profile reviews \u2014 rating, reviewer name, comment text, reply status. Returns the most recent reviews. Use to answer \"what do customers say about us?\" or \"what is our Google rating?\" 90% of customers check reviews before buying.", "operationId": "get_google_business_reviews", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_business_insights": { "post": { "summary": "Fetch Google Business Profile performance insights for a date range. Returns Maps views, Search views, website clicks, phone calls, direction requests. Use to answer \"how visible are we on Google Maps?\" or \"how many people found us via Google Business?\"", "description": "Fetch Google Business Profile performance insights for a date range. Returns Maps views, Search views, website clicks, phone calls, direction requests. Use to answer \"how visible are we on Google Maps?\" or \"how many people found us via Google Business?\"", "operationId": "get_google_business_insights", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_business_local_seo": { "post": { "summary": "Combined Google Business Profile report: location info, visibility (Maps + Search views), actions (website clicks, calls, directions), and reviews (count, average rating, 5 most recent). A single-call overview for local SEO health.", "description": "Combined Google Business Profile report: location info, visibility (Maps + Search views), actions (website clicks, calls, directions), and reviews (count, average rating, 5 most recent). A single-call overview for local SEO health.", "operationId": "get_google_business_local_seo", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gsc_brand_queries": { "post": { "summary": "Filter Google Search Console queries by brand name and compute brand click share. Returns brand clicks, brand impressions, total clicks, total impressions, brand_click_share_pct (%), and the top individual brand queries. Use to answer \"what share of our organic traffic comes from people searching our brand name?\" Pass brand_keyword for the exact brand term; if omitted, the project name is used.", "description": "Filter Google Search Console queries by brand name and compute brand click share. Returns brand clicks, brand impressions, total clicks, total impressions, brand_click_share_pct (%), and the top individual brand queries. Use to answer \"what share of our organic traffic comes from people searching our brand name?\" Pass brand_keyword for the exact brand term; if omitted, the project name is used.", "operationId": "get_gsc_brand_queries", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "brand_keyword": { "type": "string", "description": "Brand name to filter queries by (case-insensitive contains match)" }, "limit": { "type": "integer", "default": 20, "description": "Max brand queries to return" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_ga4_new_vs_returning": { "post": { "summary": "Break down website visitors into new vs returning users from GA4. Returns sessions, users, engagement rate, and average session duration for each group. Use to answer \"do we have a loyal audience?\" or \"what percentage of visitors come back?\" Target: ~60-70% new, 30-40% returning.", "description": "Break down website visitors into new vs returning users from GA4. Returns sessions, users, engagement rate, and average session duration for each group. Use to answer \"do we have a loyal audience?\" or \"what percentage of visitors come back?\" Target: ~60-70% new, 30-40% returning.", "operationId": "get_ga4_new_vs_returning", "tags": [ "Analytics" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_clarity": { "post": { "summary": "Fetch Microsoft Clarity session insights \u2014 sessions, dead clicks, rage clicks, scroll depth, JS errors, quickback clicks, engaged sessions. Clarity API only supports the last 1, 2, or 3 days (no historical range). Optionally break down by up to 3 dimensions: Browser, Device, OS, Country, URL, Source, Medium, Campaign, Channel, NewVsReturning. Use to answer \"where do users get frustrated?\" or \"what are our UX dead spots?\"", "description": "Fetch Microsoft Clarity session insights \u2014 sessions, dead clicks, rage clicks, scroll depth, JS errors, quickback clicks, engaged sessions. Clarity API only supports the last 1, 2, or 3 days (no historical range). Optionally break down by up to 3 dimensions: Browser, Device, OS, Country, URL, Source, Medium, Campaign, Channel, NewVsReturning. Use to answer \"where do users get frustrated?\" or \"what are our UX dead spots?\"", "operationId": "get_clarity", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "num_of_days": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 3, "description": "Number of days to analyze (1, 2, or 3 \u2014 Clarity API limit)" }, "dimensions": { "type": "array", "items": { "type": "string" }, "maxItems": 3, "description": "Optional breakdown dimensions (up to 3): Browser, Device, OS, Country, URL, Source, Medium, Campaign, Channel, NewVsReturning" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bing_webmaster": { "post": { "summary": "Fetch Bing organic search performance from Bing Webmaster Tools for a date range. Returns daily clicks, impressions, CTR, and average position in Bing search results. Complements Google Search Console with Microsoft\/Bing search data.", "description": "Fetch Bing organic search performance from Bing Webmaster Tools for a date range. Returns daily clicks, impressions, CTR, and average position in Bing search results. Complements Google Search Console with Microsoft\/Bing search data.", "operationId": "get_bing_webmaster", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bing_top_queries": { "post": { "summary": "Get the top Bing search queries that bring visitors to the website. Returns keyword, clicks, impressions, CTR, and average position. Use to answer \"what keywords do we rank for in Bing?\"", "description": "Get the top Bing search queries that bring visitors to the website. Returns keyword, clicks, impressions, CTR, and average position. Use to answer \"what keywords do we rank for in Bing?\"", "operationId": "get_bing_top_queries", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bing_top_pages": { "post": { "summary": "Get best-performing pages in Bing search ranked by clicks. Returns URL, clicks, impressions, CTR, and average position for each page.", "description": "Get best-performing pages in Bing search ranked by clicks. Returns URL, clicks, impressions, CTR, and average position for each page.", "operationId": "get_bing_top_pages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 10 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bing_crawl_stats": { "post": { "summary": "Get Bingbot crawl + index statistics for the connected site: pages crawled, crawl errors, indexed page count. Use for technical SEO health checks.", "description": "Get Bingbot crawl + index statistics for the connected site: pages crawled, crawl errors, indexed page count. Use for technical SEO health checks.", "operationId": "get_bing_crawl_stats", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_facebook": { "post": { "summary": "Fetch Facebook Page performance metrics for a date range. Returns page reach, post engagement (likes, comments, shares), follower count and growth, and page views. Use this for social media reporting or answering \"how is our Facebook page performing?\"", "description": "Fetch Facebook Page performance metrics for a date range. Returns page reach, post engagement (likes, comments, shares), follower count and growth, and page views. Use this for social media reporting or answering \"how is our Facebook page performing?\"", "operationId": "get_facebook", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "aggregate": { "type": "boolean", "default": false } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_facebook_posts": { "post": { "summary": "List Facebook Page posts published in a date range with reactions, likes, comments and shares. Pass metrics to return only the named numeric fields per post (e.g. [\"likes\",\"comments\",\"shares\"]) so dashboard charts plot only those; omit it to get every metric.", "description": "List Facebook Page posts published in a date range with reactions, likes, comments and shares. Pass metrics to return only the named numeric fields per post (e.g. [\"likes\",\"comments\",\"shares\"]) so dashboard charts plot only those; omit it to get every metric.", "operationId": "get_facebook_posts", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 50 }, "metrics": { "type": "array", "items": { "type": "string", "enum": [ "views", "reactions", "likes", "comments", "shares" ] }, "description": "Optional subset of per-post metrics to return: views, reactions, likes, comments, shares. Omit for all." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_instagram": { "post": { "summary": "Fetch Instagram Business account performance metrics for a date range. Returns reach, impressions, profile views, website clicks and follower count. Use this for Instagram reporting or answering \"how is our Instagram performing?\"", "description": "Fetch Instagram Business account performance metrics for a date range. Returns reach, impressions, profile views, website clicks and follower count. Use this for Instagram reporting or answering \"how is our Instagram performing?\"", "operationId": "get_instagram", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_instagram_posts": { "post": { "summary": "List Instagram Business posts published in a date range with media type, likes and comments. Pass metrics to return only the named numeric fields per post (e.g. [\"likes\",\"comments\",\"shares\",\"saves\"]) so dashboard charts plot only those; omit it to get every metric.", "description": "List Instagram Business posts published in a date range with media type, likes and comments. Pass metrics to return only the named numeric fields per post (e.g. [\"likes\",\"comments\",\"shares\",\"saves\"]) so dashboard charts plot only those; omit it to get every metric.", "operationId": "get_instagram_posts", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 50 }, "metrics": { "type": "array", "items": { "type": "string", "enum": [ "views", "reach", "total_interactions", "likes", "comments", "shares", "saves" ] }, "description": "Optional subset of per-post metrics to return: views, reach, total_interactions, likes, comments, shares, saves. Omit for all." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_linkedin": { "post": { "summary": "Fetch LinkedIn Company Page analytics for a date range. Returns post impressions, engagement metrics (reactions, comments, shares), follower count and demographics. Use this for B2B social media reporting or answering \"how is our LinkedIn performing?\"", "description": "Fetch LinkedIn Company Page analytics for a date range. Returns post impressions, engagement metrics (reactions, comments, shares), follower count and demographics. Use this for B2B social media reporting or answering \"how is our LinkedIn performing?\"", "operationId": "get_linkedin", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_linkedin_posts": { "post": { "summary": "List LinkedIn Company Page posts published in a date range, one row per post with impressions, unique impressions, clicks, reactions, comments, reposts and engagement rate (organic + sponsored combined, via the Pages Data Portability API). Newest first; each row carries the post text, media type and permalink. Use for \"which LinkedIn posts performed best\", per-post reporting, or a table\/chart_bar dashboard widget. Pass metrics to return only the named numeric fields (e.g. [\"impressions\",\"reactions\"]). get_linkedin gives the page-level totals instead.", "description": "List LinkedIn Company Page posts published in a date range, one row per post with impressions, unique impressions, clicks, reactions, comments, reposts and engagement rate (organic + sponsored combined, via the Pages Data Portability API). Newest first; each row carries the post text, media type and permalink. Use for \"which LinkedIn posts performed best\", per-post reporting, or a table\/chart_bar dashboard widget. Pass metrics to return only the named numeric fields (e.g. [\"impressions\",\"reactions\"]). get_linkedin gives the page-level totals instead.", "operationId": "get_linkedin_posts", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" }, "limit": { "type": "integer", "default": 50, "description": "Max posts to inspect (1-100). Each post costs one analytics call, so keep it modest." }, "metrics": { "type": "array", "items": { "type": "string", "enum": [ "impressions", "unique_impressions", "clicks", "reactions", "comments", "reposts", "engagement_rate" ] }, "description": "Optional subset of per-post metrics to return: impressions, unique_impressions, clicks, reactions, comments, reposts, engagement_rate. Omit for all." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_twitter": { "post": { "summary": "Fetch Twitter\/X account analytics for a date range. Returns tweet count, impressions, engagement rate, retweets, likes, replies, and profile visits. Use for social media reporting or answering \"how are our tweets performing?\"", "description": "Fetch Twitter\/X account analytics for a date range. Returns tweet count, impressions, engagement rate, retweets, likes, replies, and profile visits. Use for social media reporting or answering \"how are our tweets performing?\"", "operationId": "get_twitter", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD). Omit both dates to get the last 28 days; the response carries the dates actually used, so report the period from those rather than assuming." }, "end_date": { "type": "string", "format": "date" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tiktok": { "post": { "summary": "Fetch TikTok account overview via the Display API: display name, verified flag, follower\/following counts, total likes and video count, plus profile link. Works after the owner authorizes TikTok via OAuth (Login Kit). Use for social media reporting or answering \"how is our TikTok account doing?\"", "description": "Fetch TikTok account overview via the Display API: display name, verified flag, follower\/following counts, total likes and video count, plus profile link. Works after the owner authorizes TikTok via OAuth (Login Kit). Use for social media reporting or answering \"how is our TikTok account doing?\"", "operationId": "get_tiktok", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tiktok_videos": { "post": { "summary": "List the connected TikTok account's own videos with engagement stats: views, likes, comments, shares, title, share URL and post time. Optional max_count (default 20). Use to find top-performing TikTok content or build a posting report.", "description": "List the connected TikTok account's own videos with engagement stats: views, likes, comments, shares, title, share URL and post time. Optional max_count (default 20). Use to find top-performing TikTok content or build a posting report.", "operationId": "get_tiktok_videos", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "max_count": { "type": "integer", "description": "How many videos to return (default 20, newest first)" }, "start_date": { "type": "string", "format": "date", "description": "Ignored. TikTok Display API video listing is newest-first; filter returned videos client-side by create_time if you need a date window." }, "end_date": { "type": "string", "format": "date", "description": "Ignored. TikTok Display API video listing is newest-first; filter returned videos client-side by create_time if you need a date window." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/post_tiktok_video": { "post": { "summary": "Publish a video to the connected TikTok account (Content Posting API Direct Post). Requires the connection to be authorized with the video.publish scope \u2014 if you get a scope_not_authorized error, the owner must re-authorize TikTok. Pass a public video_url TikTok pulls from (the domain must be verified in the TikTok developer portal). privacy_level defaults to SELF_ONLY (private); PUBLIC_TO_EVERYONE works only after TikTok's content-posting audit AND if the creator allows it \u2014 call with the caption drafted via the normal draft-approval flow first. Returns a publish_id; poll get_tiktok_post_status until PUBLISH_COMPLETE.", "description": "Publish a video to the connected TikTok account (Content Posting API Direct Post). Requires the connection to be authorized with the video.publish scope \u2014 if you get a scope_not_authorized error, the owner must re-authorize TikTok. Pass a public video_url TikTok pulls from (the domain must be verified in the TikTok developer portal). privacy_level defaults to SELF_ONLY (private); PUBLIC_TO_EVERYONE works only after TikTok's content-posting audit AND if the creator allows it \u2014 call with the caption drafted via the normal draft-approval flow first. Returns a publish_id; poll get_tiktok_post_status until PUBLISH_COMPLETE.", "operationId": "post_tiktok_video", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "video_url", "title" ], "properties": { "video_url": { "type": "string", "description": "Public HTTPS URL of the video file (mp4). Domain must be verified for the TikTok app." }, "title": { "type": "string", "description": "Caption\/title, max 2200 chars, may contain #hashtags and @mentions." }, "privacy_level": { "type": "string", "enum": [ "SELF_ONLY", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "PUBLIC_TO_EVERYONE" ], "description": "Default SELF_ONLY. Must be one of the creator's allowed options (checked automatically)." }, "disable_comment": { "type": "boolean", "description": "Turn off comments on this post." }, "disable_duet": { "type": "boolean", "description": "Disallow duets." }, "disable_stitch": { "type": "boolean", "description": "Disallow stitches." }, "video_cover_timestamp_ms": { "type": "integer", "description": "Frame (ms) to use as the cover image." }, "is_aigc": { "type": "boolean", "description": "Mark the video as AI-generated content (TikTok shows the AI-generated label). Set true for any video produced with AI tools." }, "brand_organic_toggle": { "type": "boolean", "description": "Commercial content disclosure: true when the video promotes the creator's OWN business\/products (most company-account posts)." }, "brand_content_toggle": { "type": "boolean", "description": "Commercial content disclosure: true when the video is a PAID partnership promoting a third-party business (TikTok adds the \"Paid partnership\" label)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tiktok_post_status": { "post": { "summary": "Check the processing state of a TikTok video posted with post_tiktok_video. Returns status (PROCESSING_DOWNLOAD \u2192 PUBLISH_COMPLETE or FAILED) plus the fail_reason when TikTok rejected the video. Poll every ~30s until terminal.", "description": "Check the processing state of a TikTok video posted with post_tiktok_video. Returns status (PROCESSING_DOWNLOAD \u2192 PUBLISH_COMPLETE or FAILED) plus the fail_reason when TikTok rejected the video. Poll every ~30s until terminal.", "operationId": "get_tiktok_post_status", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "publish_id" ], "properties": { "publish_id": { "type": "string", "description": "The publish_id returned by post_tiktok_video." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tiktok_creator_info": { "post": { "summary": "Read the connected TikTok creator's posting settings BEFORE composing a post: which privacy levels the account may use (privacy_level_options \u2014 PUBLIC_TO_EVERYONE appears only once the app has passed TikTok's content-posting audit AND the account is public), whether the creator has disabled comments\/duets\/stitches (those cannot be re-enabled per post), the max video duration, and the creator nickname\/avatar. Call this first, build the post from its answers, then call post_tiktok_video. Also the quickest way to check whether public posting is unlocked yet: posting_unlocked=true.", "description": "Read the connected TikTok creator's posting settings BEFORE composing a post: which privacy levels the account may use (privacy_level_options \u2014 PUBLIC_TO_EVERYONE appears only once the app has passed TikTok's content-posting audit AND the account is public), whether the creator has disabled comments\/duets\/stitches (those cannot be re-enabled per post), the max video duration, and the creator nickname\/avatar. Call this first, build the post from its answers, then call post_tiktok_video. Also the quickest way to check whether public posting is unlocked yet: posting_unlocked=true.", "operationId": "get_tiktok_creator_info", "tags": [ "Social Media" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_ads": { "post": { "summary": "Fetch Google Ads campaign performance data for a date range. Returns impressions, clicks, CTR, average CPC, total cost, conversions, and cost per conversion for each campaign. Optionally filter by campaign_id. Use for paid search reporting or answering \"how are our Google Ads performing?\" or \"what is our ad spend ROI?\"", "description": "Fetch Google Ads campaign performance data for a date range. Returns impressions, clicks, CTR, average CPC, total cost, conversions, and cost per conversion for each campaign. Optionally filter by campaign_id. Use for paid search reporting or answering \"how are our Google Ads performing?\" or \"what is our ad spend ROI?\"", "operationId": "get_google_ads", "tags": [ "Advertising" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD, today, yesterday, or NdaysAgo such as 30daysAgo). Omit both dates to get the last 28 days." }, "end_date": { "type": "string", "format": "date", "description": "End date (YYYY-MM-DD, today, yesterday, or NdaysAgo)." }, "campaign_id": { "type": "string", "description": "Specific campaign ID (optional)" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_meta_ads": { "post": { "summary": "Fetch Meta Ads (Facebook & Instagram) campaign performance for a date range. Returns spend, impressions, reach, clicks, CTR, CPC, conversions, cost per result, and ROAS for each campaign. Use for paid social reporting or answering \"how are our Facebook\/Instagram ads performing?\" or \"what is our Meta Ads ROAS?\"", "description": "Fetch Meta Ads (Facebook & Instagram) campaign performance for a date range. Returns spend, impressions, reach, clicks, CTR, CPC, conversions, cost per result, and ROAS for each campaign. Use for paid social reporting or answering \"how are our Facebook\/Instagram ads performing?\" or \"what is our Meta Ads ROAS?\"", "operationId": "get_meta_ads", "tags": [ "Advertising" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "format": "date", "description": "Start date (YYYY-MM-DD, today, yesterday, or NdaysAgo such as 30daysAgo). Omit both dates to get the last 28 days." }, "end_date": { "type": "string", "format": "date", "description": "End date (YYYY-MM-DD, today, yesterday, or NdaysAgo)." } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_wp_posts": { "post": { "summary": "List WordPress blog posts with filtering and sorting. Returns post title, status, date, excerpt, categories, and tags. Filter by status (publish\/draft\/pending), search by keyword, and sort by date, title, or modification date. Use for content audits, finding specific posts, or answering \"what blog posts do we have?\" or \"show me recent drafts.\"", "description": "List WordPress blog posts with filtering and sorting. Returns post title, status, date, excerpt, categories, and tags. Filter by status (publish\/draft\/pending), search by keyword, and sort by date, title, or modification date. Use for content audits, finding specific posts, or answering \"what blog posts do we have?\" or \"show me recent drafts.\"", "operationId": "list_wp_posts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "publish", "draft", "pending", "private", "any" ], "description": "Post status filter", "default": "publish" }, "per_page": { "type": "integer", "default": 10, "description": "Posts per page" }, "page": { "type": "integer", "default": 1 }, "search": { "type": "string", "description": "Search term" }, "order": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" }, "orderby": { "type": "string", "enum": [ "date", "title", "modified" ], "default": "date" }, "start_date": { "type": "string", "description": "Include posts published on or after this date (YYYY-MM-DD)" }, "end_date": { "type": "string", "description": "Include posts published on or before this date (YYYY-MM-DD)" }, "after": { "type": "string", "description": "Alias for start_date. Accepts YYYY-MM-DD or a WordPress REST after timestamp." }, "before": { "type": "string", "description": "Alias for end_date. Accepts YYYY-MM-DD or a WordPress REST before timestamp." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wp_post": { "post": { "summary": "Retrieve a single WordPress post with full content, title, excerpt, categories, tags, featured image, author, and publication date. Use when you need the complete post content for editing, SEO analysis, or content review.", "description": "Retrieve a single WordPress post with full content, title, excerpt, categories, tags, featured image, author, and publication date. Use when you need the complete post content for editing, SEO analysis, or content review.", "operationId": "get_wp_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "post_id" ], "properties": { "post_id": { "type": "integer", "description": "WordPress post ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_wp_post": { "post": { "summary": "Create and publish a new WordPress blog post. Provide title and HTML content, optionally set status (default: draft), excerpt, categories, tags, featured image, and SEO meta description. Use when the user wants to \"write a blog post\", \"publish an article\", or \"create content on WordPress.\"", "description": "Create and publish a new WordPress blog post. Provide title and HTML content, optionally set status (default: draft), excerpt, categories, tags, featured image, and SEO meta description. Use when the user wants to \"write a blog post\", \"publish an article\", or \"create content on WordPress.\"", "operationId": "create_wp_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "title", "content" ], "properties": { "title": { "type": "string", "description": "Post title" }, "content": { "type": "string", "description": "Post content (HTML)" }, "status": { "type": "string", "enum": [ "publish", "draft", "pending", "private" ], "default": "draft", "description": "Post status" }, "excerpt": { "type": "string", "description": "Post excerpt" }, "slug": { "type": "string", "description": "Optional URL slug for the post." }, "categories": { "type": "array", "items": { "type": "integer" }, "description": "Category IDs (see list_wp_categories). Prefer category_names if you only know the names." }, "category_names": { "type": "array", "items": { "type": "string" }, "description": "Category names or slugs, e.g. [\"SEO\", \"Turundus\"]. Resolved to IDs; an unknown category fails the call (categories are never auto-created)." }, "tags": { "type": "array", "items": { "type": "integer" }, "description": "Tag IDs (see list_wp_tags). Prefer tag_names if you only know the names." }, "tag_names": { "type": "array", "items": { "type": "string" }, "description": "Tag names, e.g. [\"AI turundus\", \"GEO\"]. Existing tags are matched by name\/slug, missing ones are created automatically." }, "featured_media": { "type": "integer", "description": "Featured image ID" }, "meta_description": { "type": "string", "description": "SEO meta description" }, "author": { "type": "string", "description": "Post author as WordPress user ID, login (e.g. \"diana\"), email or display name. Defaults to the user behind the WordPress connection. Needs the connection user to be editor\/administrator." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_wp_post": { "post": { "summary": "Update an existing WordPress post by ID. Can modify title, content, status, excerpt, categories, tags, featured image, and SEO meta description. Only include fields you want to change. Use when the user wants to \"edit a post\", \"update the blog\", or \"change post status to published.\"", "description": "Update an existing WordPress post by ID. Can modify title, content, status, excerpt, categories, tags, featured image, and SEO meta description. Only include fields you want to change. Use when the user wants to \"edit a post\", \"update the blog\", or \"change post status to published.\"", "operationId": "update_wp_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "post_id" ], "properties": { "post_id": { "type": "integer", "description": "WordPress post ID" }, "title": { "type": "string" }, "content": { "type": "string" }, "status": { "type": "string", "enum": [ "publish", "draft", "pending", "private" ] }, "excerpt": { "type": "string" }, "categories": { "type": "array", "items": { "type": "integer" } }, "category_names": { "type": "array", "items": { "type": "string" }, "description": "Category names\/slugs instead of IDs (replaces the post's categories)." }, "tags": { "type": "array", "items": { "type": "integer" } }, "tag_names": { "type": "array", "items": { "type": "string" }, "description": "Tag names instead of IDs (replaces the post's tags; missing tags are created)." }, "featured_media": { "type": "integer" }, "meta_description": { "type": "string" }, "author": { "type": "string", "description": "Change the post author: WordPress user ID, login, email or display name." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_wp_categories": { "post": { "summary": "List the WordPress categories (id, name, slug, post count) so you can pick category IDs\/names for create_wp_post \/ update_wp_post. Categories are never created by the agent \u2014 ask the site owner if one is missing.", "description": "List the WordPress categories (id, name, slug, post count) so you can pick category IDs\/names for create_wp_post \/ update_wp_post. Categories are never created by the agent \u2014 ask the site owner if one is missing.", "operationId": "list_wp_categories", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_wp_tags": { "post": { "summary": "List the WordPress tags (id, name, slug, post count). Use before tagging a post so you reuse existing tags instead of creating near-duplicates.", "description": "List the WordPress tags (id, name, slug, post count). Use before tagging a post so you reuse existing tags instead of creating near-duplicates.", "operationId": "list_wp_tags", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_wp_tag": { "post": { "summary": "Create a WordPress tag by name. Idempotent: if a tag with that name\/slug already exists, its id is returned with created:false. Usually you do not need this \u2014 create_wp_post \/ update_wp_post accept tag_names and create missing tags themselves.", "description": "Create a WordPress tag by name. Idempotent: if a tag with that name\/slug already exists, its id is returned with created:false. Usually you do not need this \u2014 create_wp_post \/ update_wp_post accept tag_names and create missing tags themselves.", "operationId": "create_wp_tag", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "Tag name as it should appear on the site, e.g. \"AI turundus\"." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_wp_pages": { "post": { "summary": "List WordPress PAGES (service\/landing pages, not blog posts) with id, title, slug, link and status. Use before editing a service page so you have the right page_id. Filter with search (title\/content substring) or status (publish|draft|any).", "description": "List WordPress PAGES (service\/landing pages, not blog posts) with id, title, slug, link and status. Use before editing a service page so you have the right page_id. Filter with search (title\/content substring) or status (publish|draft|any).", "operationId": "list_wp_pages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "search": { "type": "string", "description": "Substring to match in title\/content, e.g. \"kodulehe\"." }, "status": { "type": "string", "description": "publish (default), draft, pending, private, any." }, "per_page": { "type": "integer", "description": "Max rows (default 20, cap 100)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wp_page": { "post": { "summary": "Fetch one WordPress page in full (title, content, excerpt, slug, status, link) by page_id. Read it before rewriting so you keep the parts you are not changing.", "description": "Fetch one WordPress page in full (title, content, excerpt, slug, status, link) by page_id. Read it before rewriting so you keep the parts you are not changing.", "operationId": "get_wp_page", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "page_id" ], "properties": { "page_id": { "type": "integer" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_wp_page": { "post": { "summary": "Update a WordPress service\/landing PAGE: title, content (full HTML \u2014 send the complete body, it replaces the old one), excerpt, slug or status. This is how CTR fixes on service pages get done without wp-admin. Pass only the fields you are changing.", "description": "Update a WordPress service\/landing PAGE: title, content (full HTML \u2014 send the complete body, it replaces the old one), excerpt, slug or status. This is how CTR fixes on service pages get done without wp-admin. Pass only the fields you are changing.", "operationId": "update_wp_page", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "page_id" ], "properties": { "page_id": { "type": "integer" }, "title": { "type": "string", "description": "Page H1\/title." }, "content": { "type": "string", "description": "Full HTML body \u2014 replaces the existing content." }, "excerpt": { "type": "string" }, "slug": { "type": "string", "description": "URL slug. Changing it breaks old links \u2014 pair with create_wp_redirect." }, "status": { "type": "string", "description": "publish | draft | pending | private." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wp_seo_meta": { "post": { "summary": "Read the current Rank Math SEO fields (SEO title, meta description, focus keyword, canonical) for a post or page. Use before rewriting a title so you know the current length and wording.", "description": "Read the current Rank Math SEO fields (SEO title, meta description, focus keyword, canonical) for a post or page. Use before rewriting a title so you know the current length and wording.", "operationId": "get_wp_seo_meta", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "object_id" ], "properties": { "object_id": { "type": "integer", "description": "Post or page ID." }, "type": { "type": "string", "description": "posts (default) or pages." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_wp_seo_meta": { "post": { "summary": "Set Rank Math SEO fields for a post or page: SEO title, meta description, focus keyword (rank_math_focus_keyword), canonical URL, robots, and the Open Graph \/ social share image. This is the CTR lever: rewrite the search-result title and description without touching the page content. Keep seo_title <= 60 chars and meta_description <= 155 chars. Use this right after create_wp_post to set the Rank Math focus keyword.", "description": "Set Rank Math SEO fields for a post or page: SEO title, meta description, focus keyword (rank_math_focus_keyword), canonical URL, robots, and the Open Graph \/ social share image. This is the CTR lever: rewrite the search-result title and description without touching the page content. Keep seo_title <= 60 chars and meta_description <= 155 chars. Use this right after create_wp_post to set the Rank Math focus keyword.", "operationId": "update_wp_seo_meta", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "object_id" ], "properties": { "object_id": { "type": "integer", "description": "Post or page ID." }, "type": { "type": "string", "description": "Accepted for compatibility with get_wp_seo_meta: posts\/post or pages\/page." }, "seo_title": { "type": "string", "description": "Title shown in Google (max ~60 chars)." }, "meta_description": { "type": "string", "description": "Description shown in Google (max ~155 chars)." }, "focus_keyword": { "type": "string", "description": "Rank Math focus keyword(s); separate several with commas, primary first." }, "canonical_url": { "type": "string", "description": "Absolute URL \u2014 use when two pages compete for the same query." }, "robots": { "type": "array", "items": { "type": "string" }, "description": "e.g. [\"index\",\"follow\"] or [\"noindex\"]." }, "og_image": { "type": "string", "description": "Absolute URL of the Open Graph \/ Facebook share image (Rank Math \"Facebook image\"; Twitter uses it too by default). Pass a media library URL, e.g. the featured image URL." }, "og_image_id": { "type": "integer", "description": "Media library attachment ID of og_image, when known (lets Rank Math pick the right size)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_wp_redirect": { "post": { "summary": "Create a 301 (or 302) redirect. Use when consolidating duplicate pages, retiring an old URL, or after changing a slug. \"from\" is a site-relative path with a leading slash; \"to\" may be relative or absolute. The platform detects the site's redirect backend itself: the Redirection plugin (Tools \u2192 Redirection) when installed, else Rank Math's Redirections module \u2014 the result names which one (\"backend\") and how to verify. Redirection: an existing rule for the same source is updated in place. Rank Math only: every redirect hangs on a post, so the platform attaches it to the post still at \"from\", else the destination page \u2014 pass object_id only when neither exists. The old URL must answer with the redirect status before you record the task as done.", "description": "Create a 301 (or 302) redirect. Use when consolidating duplicate pages, retiring an old URL, or after changing a slug. \"from\" is a site-relative path with a leading slash; \"to\" may be relative or absolute. The platform detects the site's redirect backend itself: the Redirection plugin (Tools \u2192 Redirection) when installed, else Rank Math's Redirections module \u2014 the result names which one (\"backend\") and how to verify. Redirection: an existing rule for the same source is updated in place. Rank Math only: every redirect hangs on a post, so the platform attaches it to the post still at \"from\", else the destination page \u2014 pass object_id only when neither exists. The old URL must answer with the redirect status before you record the task as done.", "operationId": "create_wp_redirect", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "from", "to" ], "properties": { "from": { "type": "string", "description": "Old path, e.g. \"\/vana-leht\/\" (an absolute URL on the same site is accepted)." }, "to": { "type": "string", "description": "Destination path or URL." }, "type": { "type": "integer", "description": "301 permanent (default) or 302 temporary." }, "object_id": { "type": "integer", "description": "Optional, Rank Math backend only (ignored with the Redirection plugin). WordPress post\/page ID to attach the redirect to when neither \"from\" nor \"to\" is a post or page on this site (e.g. both URLs are archives). Usually omit." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_wp_schema": { "post": { "summary": "Set structured data (Rank Math schema) on a post or page \u2014 Article, FAQPage, Service, HowTo etc. Pass the schema map exactly as Rank Math stores it. Use to fill Article+FAQPage gaps found in a GEO\/SEO audit.", "description": "Set structured data (Rank Math schema) on a post or page \u2014 Article, FAQPage, Service, HowTo etc. Pass the schema map exactly as Rank Math stores it. Use to fill Article+FAQPage gaps found in a GEO\/SEO audit.", "operationId": "update_wp_schema", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "object_id", "schemas" ], "properties": { "object_id": { "type": "integer" }, "schemas": { "type": "object", "description": "Rank Math schema map, e.g. {\"schema-1\":{\"@type\":\"FAQPage\",\"mainEntity\":[...]}}." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/analyze_wp_seo": { "post": { "summary": "Run an AI-powered SEO analysis on a WordPress post. Checks readability score, keyword density, meta tags, heading structure, content length, internal\/external links, and Yoast SEO data if available. Optionally provide a focus keyword for targeted analysis. Returns actionable recommendations to improve search rankings. Use when asked to \"check SEO\" or \"optimize a blog post.\"", "description": "Run an AI-powered SEO analysis on a WordPress post. Checks readability score, keyword density, meta tags, heading structure, content length, internal\/external links, and Yoast SEO data if available. Optionally provide a focus keyword for targeted analysis. Returns actionable recommendations to improve search rankings. Use when asked to \"check SEO\" or \"optimize a blog post.\"", "operationId": "analyze_wp_seo", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "post_id" ], "properties": { "post_id": { "type": "integer", "description": "WordPress post ID" }, "focus_keyword": { "type": "string", "description": "Focus keyword for SEO analysis" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gtm_container": { "post": { "summary": "Overview of the connected Google Tag Manager container: name, GTM-XXXX public id, active workspace, counts of tags\/triggers\/variables (also tags by type and paused tags) and the currently published live version. Start here before adding or editing tags.", "description": "Overview of the connected Google Tag Manager container: name, GTM-XXXX public id, active workspace, counts of tags\/triggers\/variables (also tags by type and paused tags) and the currently published live version. Start here before adding or editing tags.", "operationId": "get_gtm_container", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_gtm_tags": { "post": { "summary": "List the tags in the GTM workspace: id, name, type (gaawe = GA4 event, googtag = Google tag, html = custom HTML), firing_trigger_ids, paused flag and condensed parameters. Optional search filters by name substring. Check here whether a tag already exists before creating one.", "description": "List the tags in the GTM workspace: id, name, type (gaawe = GA4 event, googtag = Google tag, html = custom HTML), firing_trigger_ids, paused flag and condensed parameters. Optional search filters by name substring. Check here whether a tag already exists before creating one.", "operationId": "list_gtm_tags", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "search": { "type": "string", "description": "Case-insensitive substring to match against tag names, e.g. \"form\" or \"GA4\"" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_gtm_triggers": { "post": { "summary": "List the triggers in the GTM workspace: id, name, type (pageview, click, linkClick, formSubmission, customEvent, elementVisibility, scrollDepth, timer...) and the condensed firing conditions {type, parameter_key, value}. Use the ids as firing_trigger_ids when creating or updating tags.", "description": "List the triggers in the GTM workspace: id, name, type (pageview, click, linkClick, formSubmission, customEvent, elementVisibility, scrollDepth, timer...) and the condensed firing conditions {type, parameter_key, value}. Use the ids as firing_trigger_ids when creating or updating tags.", "operationId": "list_gtm_triggers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_gtm_variables": { "post": { "summary": "List the user-defined variables in the GTM workspace: id, name, type (v = data layer variable, c = constant, jsm = custom JavaScript, k = 1st-party cookie, u = URL, aev = auto-event variable) and their parameters. Reference one in tags and trigger conditions as {{Variable Name}}.", "description": "List the user-defined variables in the GTM workspace: id, name, type (v = data layer variable, c = constant, jsm = custom JavaScript, k = 1st-party cookie, u = URL, aev = auto-event variable) and their parameters. Reference one in tags and trigger conditions as {{Variable Name}}.", "operationId": "list_gtm_variables", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_gtm_tag": { "post": { "summary": "Add a tag to the GTM WORKSPACE: a GA4 event tag for form_start or cta_click (type gaawe, parameters {measurementId, eventName, eventParameters}) or custom HTML (type html, {html}). firing_trigger_ids come from list_gtm_triggers. Publish is NOT available: the human publishes the version in GTM.", "description": "Add a tag to the GTM WORKSPACE: a GA4 event tag for form_start or cta_click (type gaawe, parameters {measurementId, eventName, eventParameters}) or custom HTML (type html, {html}). firing_trigger_ids come from list_gtm_triggers. Publish is NOT available: the human publishes the version in GTM.", "operationId": "create_gtm_tag", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name", "type", "firing_trigger_ids" ], "properties": { "name": { "type": "string", "description": "Tag name as shown in GTM, e.g. \"GA4 - form_start\"" }, "type": { "type": "string", "description": "GTM tag type id: gaawe (GA4 event), googtag (Google tag \/ GA4 configuration), html (custom HTML), img (custom image), awct (Google Ads conversion), gclidw (conversion linker)" }, "parameters": { "type": "object", "description": "Tag parameters as key\/value pairs. gaawe: measurementId (G-XXXX, or the name of a Google tag to reference), eventName, eventParameters {name: value}. googtag: measurementId. html: html, supportDocumentWrite (boolean). Values may reference variables as {{Variable Name}}." }, "firing_trigger_ids": { "type": "array", "items": { "type": [ "string", "integer" ] }, "description": "Ids of the triggers that fire the tag (from list_gtm_triggers or create_gtm_trigger). At least one." }, "blocking_trigger_ids": { "type": "array", "items": { "type": [ "string", "integer" ] }, "description": "Optional exception trigger ids that block the tag from firing" }, "notes": { "type": "string", "description": "Optional note shown in GTM: why the tag exists, who asked for it" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_gtm_trigger": { "post": { "summary": "Add a trigger to the GTM WORKSPACE: type pageview, click, linkClick, formSubmission, customEvent, elementVisibility, scrollDepth, timer. filters narrow it (e.g. Click Classes contains btn-cta); customEvent needs custom_event_name. Returns the id for create_gtm_tag. The human publishes in GTM.", "description": "Add a trigger to the GTM WORKSPACE: type pageview, click, linkClick, formSubmission, customEvent, elementVisibility, scrollDepth, timer. filters narrow it (e.g. Click Classes contains btn-cta); customEvent needs custom_event_name. Returns the id for create_gtm_tag. The human publishes in GTM.", "operationId": "create_gtm_trigger", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name", "type" ], "properties": { "name": { "type": "string", "description": "Trigger name as shown in GTM, e.g. \"Click - CTA button\"" }, "type": { "type": "string", "description": "GTM trigger type: pageview, domReady, windowLoaded, click, linkClick, formSubmission, customEvent, elementVisibility, scrollDepth, timer, historyChange, jsError, youTubeVideo" }, "filters": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Condition: equals, contains, startsWith, endsWith, matchRegex, greater, greaterOrEquals, less, lessOrEquals, cssSelector, urlMatches" }, "parameter_key": { "type": "string", "description": "Built-in or user variable the condition reads, without braces: Click Classes, Click URL, Page URL, Page Path, Form ID, Click Element..." }, "value": { "type": [ "string", "number" ], "description": "Value to compare against, e.g. \"btn-cta\" or \"\/contact\"" }, "negate": { "type": "boolean", "description": "Invert the condition (\"does not contain\")" } } }, "description": "Firing conditions (\"Some clicks \/ Some pages\"). Omit for \"All clicks \/ All pages\"." }, "custom_event_name": { "type": "string", "description": "Only for type customEvent: the dataLayer event name the site pushes, e.g. form_start or purchase" }, "custom_event_use_regex": { "type": "boolean", "description": "Only for customEvent: treat custom_event_name as a regular expression" }, "parameters": { "type": "object", "description": "Type-specific settings, e.g. elementVisibility {selectorType: \"CSS\", elementSelector: \".pricing\", onScreenRatio: 50, firingFrequency: \"ONCE\"}, scrollDepth {verticalThresholdsPercent: \"25,50,75,90\"}, timer {interval: 5000, limit: 1}" }, "notes": { "type": "string", "description": "Optional note shown in GTM" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_gtm_variable": { "post": { "summary": "Add a user-defined variable to the GTM WORKSPACE: type v (data layer, parameters {name}), c (constant, {value}), jsm (custom JavaScript, {javascript}), k (cookie), u (URL, {component}). Reference it afterwards as {{Variable Name}} in tags and triggers. Not published: the human publishes in GTM.", "description": "Add a user-defined variable to the GTM WORKSPACE: type v (data layer, parameters {name}), c (constant, {value}), jsm (custom JavaScript, {javascript}), k (cookie), u (URL, {component}). Reference it afterwards as {{Variable Name}} in tags and triggers. Not published: the human publishes in GTM.", "operationId": "create_gtm_variable", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name", "type" ], "properties": { "name": { "type": "string", "description": "Variable name as shown in GTM, e.g. \"DL - form_id\"; referenced later as {{DL - form_id}}" }, "type": { "type": "string", "description": "GTM variable type id: v (data layer), c (constant), jsm (custom JavaScript), k (1st-party cookie), j (JavaScript variable), u (URL), aev (auto-event variable), smm (lookup table)" }, "parameters": { "type": "object", "description": "Type-specific settings: v {name, dataLayerVersion (default 2), defaultValue}; c {value}; jsm {javascript}; k {name}; j {name}; u {component: URL|HOST|PATH|QUERY|FRAGMENT, queryKey}; aev {varType: ELEMENT|TEXT|URL|ATTRIBUTE, attribute}" }, "notes": { "type": "string", "description": "Optional note shown in GTM" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_gtm_tag": { "post": { "summary": "Edit an existing tag in the GTM WORKSPACE by tag_id (from list_gtm_tags): rename it, change or add parameters (merged by key, the rest is kept), replace firing_trigger_ids, or pause\/unpause it with paused. Fields left out stay as they are. Not live until the human publishes the version in GTM.", "description": "Edit an existing tag in the GTM WORKSPACE by tag_id (from list_gtm_tags): rename it, change or add parameters (merged by key, the rest is kept), replace firing_trigger_ids, or pause\/unpause it with paused. Fields left out stay as they are. Not live until the human publishes the version in GTM.", "operationId": "update_gtm_tag", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "tag_id" ], "properties": { "tag_id": { "type": [ "string", "integer" ], "description": "Tag id from list_gtm_tags" }, "name": { "type": "string", "description": "New tag name" }, "parameters": { "type": "object", "description": "Parameters to set, same keys as create_gtm_tag (e.g. eventName, measurementId, eventParameters, html). Merged by key into the existing parameters." }, "firing_trigger_ids": { "type": "array", "items": { "type": [ "string", "integer" ] }, "description": "Replaces the firing trigger list (at least one id)" }, "blocking_trigger_ids": { "type": "array", "items": { "type": [ "string", "integer" ] }, "description": "Replaces the exception trigger list; pass [] to clear" }, "paused": { "type": "boolean", "description": "true pauses the tag (it stays in the container but never fires), false resumes it" }, "notes": { "type": "string", "description": "Replace the note shown in GTM" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/delete_gtm_tag": { "post": { "summary": "Delete a tag from the GTM WORKSPACE by tag_id (from list_gtm_tags). Prefer update_gtm_tag with paused: true when the tag might be needed again. The deletion only reaches the live site once the human publishes the workspace in the GTM UI; there is no publish tool.", "description": "Delete a tag from the GTM WORKSPACE by tag_id (from list_gtm_tags). Prefer update_gtm_tag with paused: true when the tag might be needed again. The deletion only reaches the live site once the human publishes the workspace in the GTM UI; there is no publish tool.", "operationId": "delete_gtm_tag", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "tag_id" ], "properties": { "tag_id": { "type": [ "string", "integer" ], "description": "Tag id from list_gtm_tags" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_emails": { "post": { "summary": "Retrieve a list of emails from the connected email account. Returns sender, recipient, subject, date, seen state, and body preview. Filter by mailbox folder, date range, sender, subject, unread state, and limit results. Use for reviewing email history or answering \"what emails have we sent?\" or \"show recent email activity.\"", "description": "Retrieve a list of emails from the connected email account. Returns sender, recipient, subject, date, seen state, and body preview. Filter by mailbox folder, date range, sender, subject, unread state, and limit results. Use for reviewing email history or answering \"what emails have we sent?\" or \"show recent email activity.\"", "operationId": "get_emails", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 50 }, "folder": { "type": "string", "description": "Mailbox folder to read. Accepts inbox, sent\/Sent, sentitems\/Sent Items, drafts, archive, junk\/spam, deleted\/trash." }, "status": { "type": "string", "enum": [ "sent", "scheduled", "draft", "failed" ], "description": "Legacy alias for folder where possible: sent maps to the sent mailbox, draft maps to drafts. scheduled\/failed are not mailbox folders." }, "unread_only": { "type": "boolean", "description": "Only include unread messages." }, "from": { "type": "string", "description": "Only include messages from this email address." }, "subject_contains": { "type": "string", "description": "Only include messages whose subject contains this text." }, "start_date": { "type": "string", "description": "Only include emails on or after this date (YYYY-MM-DD)." }, "end_date": { "type": "string", "description": "Only include emails on or before this date (YYYY-MM-DD)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_email": { "post": { "summary": "Send an email immediately via the connected email service. Supports HTML or plain text body, CC\/BCC recipients, and file attachments. Use when the user asks to \"send an email\", \"email this to someone\", or \"reach out to a client.\"", "description": "Send an email immediately via the connected email service. Supports HTML or plain text body, CC\/BCC recipients, and file attachments. Use when the user asks to \"send an email\", \"email this to someone\", or \"reach out to a client.\"", "operationId": "send_email", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "to", "subject", "body" ], "properties": { "to": { "type": "string", "description": "Recipient email address" }, "subject": { "type": "string", "description": "Email subject" }, "body": { "type": "string", "description": "Email body (HTML or plain text)" }, "html": { "type": "boolean", "default": true, "description": "Is body HTML?" }, "cc": { "type": "array", "items": { "type": "string" }, "description": "CC recipients" }, "bcc": { "type": "array", "items": { "type": "string" }, "description": "BCC recipients" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "filename": { "type": "string" }, "path": { "type": "string" } } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/schedule_email": { "post": { "summary": "Schedule an email to be sent at a specific future date and time. Provide recipient, subject, body (HTML or plain text), and the exact send time (YYYY-MM-DD HH:MM:SS). Supports CC\/BCC. Use when the user wants to \"send this email tomorrow\" or \"schedule a follow-up email.\"", "description": "Schedule an email to be sent at a specific future date and time. Provide recipient, subject, body (HTML or plain text), and the exact send time (YYYY-MM-DD HH:MM:SS). Supports CC\/BCC. Use when the user wants to \"send this email tomorrow\" or \"schedule a follow-up email.\"", "operationId": "schedule_email", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "to", "subject", "body", "send_at" ], "properties": { "to": { "type": "string" }, "subject": { "type": "string" }, "body": { "type": "string" }, "html": { "type": "boolean", "default": true }, "send_at": { "type": "string", "description": "When to send (YYYY-MM-DD HH:MM:SS)" }, "cc": { "type": "array", "items": { "type": "string" } }, "bcc": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_email_campaigns": { "post": { "summary": "List email marketing campaigns with their name, status, and creation date. Use to get an overview of all campaigns or when the user asks \"what email campaigns do we have?\" or \"show me our marketing emails.\"", "description": "List email marketing campaigns with their name, status, and creation date. Use to get an overview of all campaigns or when the user asks \"what email campaigns do we have?\" or \"show me our marketing emails.\"", "operationId": "get_email_campaigns", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_campaign_stats": { "post": { "summary": "Get detailed performance statistics for a specific email campaign by ID. Returns total recipients, sent count, failed count, and pending count. Use for campaign performance review or answering \"how did our email campaign perform?\" or \"what are the stats for campaign X?\"", "description": "Get detailed performance statistics for a specific email campaign by ID. Returns total recipients, sent count, failed count, and pending count. Use for campaign performance review or answering \"how did our email campaign perform?\" or \"what are the stats for campaign X?\"", "operationId": "get_campaign_stats", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "campaign_id" ], "properties": { "campaign_id": { "type": "integer", "description": "Email campaign ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark": { "post": { "summary": "Comprehensive SEO snapshot from sharks.pw\/seo: project info, keyword list with positions, backlinks overview + toxic backlinks, content overview + technical SEO. One call returns everything needed for a quick SEO health check. Use for \"how is our SEO?\" or weekly SEO summaries.", "description": "Comprehensive SEO snapshot from sharks.pw\/seo: project info, keyword list with positions, backlinks overview + toxic backlinks, content overview + technical SEO. One call returns everything needed for a quick SEO health check. Use for \"how is our SEO?\" or weekly SEO summaries.", "operationId": "get_seoshark", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark_keywords": { "post": { "summary": "Tracked keyword positions from sharks.pw\/seo. Returns keyword, current Google position, optional search-volume\/difficulty depending on what the project tracks. Use for \"what keywords do we rank for?\" or to feed weekly SEO reports.", "description": "Tracked keyword positions from sharks.pw\/seo. Returns keyword, current Google position, optional search-volume\/difficulty depending on what the project tracks. Use for \"what keywords do we rank for?\" or to feed weekly SEO reports.", "operationId": "get_seoshark_keywords", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 50, "description": "Max keywords to return" }, "keyword": { "type": "string", "description": "Filter to a single keyword (optional)" }, "country": { "type": "string", "description": "Select which SeoShark project by country (e.g. \"EE\", \"FI\") when the project has more than one. Defaults to the first." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark_keyword_history": { "post": { "summary": "Position history for a single keyword from sharks.pw\/seo \u2014 daily\/weekly position snapshots over time. Use for \"how did keyword X trend?\" or to detect ranking improvements\/regressions.", "description": "Position history for a single keyword from sharks.pw\/seo \u2014 daily\/weekly position snapshots over time. Use for \"how did keyword X trend?\" or to detect ranking improvements\/regressions.", "operationId": "get_seoshark_keyword_history", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Keyword to look up history for" }, "limit": { "type": "integer", "description": "Ignored compatibility field. Keyword history returns the full available history for the keyword." } }, "required": [ "keyword" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark_keywords_history": { "post": { "summary": "Multi-keyword position history pivoted as time-series rows for chart_line widgets. Returns one row per date with one numeric column per keyword (lower number = better Google position). If keywords[] is empty, picks the top N currently best-ranking keywords. RULE: the keyword-positions trend must ALWAYS be rendered as a `chart_line` widget with display_config.y_axis.reverse=true (so #1 sits at the top) \u2014 on every dashboard, for every client. NEVER render this trend as a text_markdown Unicode sparkline; text_markdown is allowed only for separate narrative commentary beside the chart. Canonical example: https:\/\/sharksapi.ai\/sQCNQlcC52bKS9EIBQxs3PBFVnL6mNzq\/index.html", "description": "Multi-keyword position history pivoted as time-series rows for chart_line widgets. Returns one row per date with one numeric column per keyword (lower number = better Google position). If keywords[] is empty, picks the top N currently best-ranking keywords. RULE: the keyword-positions trend must ALWAYS be rendered as a `chart_line` widget with display_config.y_axis.reverse=true (so #1 sits at the top) \u2014 on every dashboard, for every client. NEVER render this trend as a text_markdown Unicode sparkline; text_markdown is allowed only for separate narrative commentary beside the chart. Canonical example: https:\/\/sharksapi.ai\/sQCNQlcC52bKS9EIBQxs3PBFVnL6mNzq\/index.html", "operationId": "get_seoshark_keywords_history", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Specific keywords to plot. Leave empty to auto-pick top_n." }, "top_n": { "type": "integer", "default": 5, "description": "How many top-ranking keywords to plot when keywords[] is empty" }, "days": { "type": "integer", "default": 30, "description": "Lookback window in days" }, "country": { "type": "string", "description": "When the project has more than one SeoShark project (e.g. \"EE\" and \"FI\"), select which by country code. Defaults to the first connection." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark_backlinks": { "post": { "summary": "Backlink list from sharks.pw\/seo with referring domain, anchor text, and dofollow\/nofollow type. Filter by all|dofollow|nofollow|toxic. Use for link-building reviews and toxic-link audits.", "description": "Backlink list from sharks.pw\/seo with referring domain, anchor text, and dofollow\/nofollow type. Filter by all|dofollow|nofollow|toxic. Use for link-building reviews and toxic-link audits.", "operationId": "get_seoshark_backlinks", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 100 }, "domain": { "type": "string", "description": "Optional safety check. This tool can only read the domain attached to the connected SeoShark project; for arbitrary domains use backlinks_summary(target=domain)." }, "type": { "type": "string", "enum": [ "all", "dofollow", "nofollow", "toxic" ], "default": "all" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_seoshark_content": { "post": { "summary": "Content overview + technical SEO + word cloud from sharks.pw\/seo. Returns total pages crawled, word count, common terms, and technical issues (missing titles, broken links, slow pages). Use for \"what content do we have?\" or technical SEO audits.", "description": "Content overview + technical SEO + word cloud from sharks.pw\/seo. Returns total pages crawled, word count, common terms, and technical issues (missing titles, broken links, slow pages). Use for \"what content do we have?\" or technical SEO audits.", "operationId": "get_seoshark_content", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "word_cloud_limit": { "type": "integer", "default": 50, "description": "Top N terms in the word cloud" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_web_mentions": { "post": { "summary": "DEPRECATED: use get_social_mentions instead. This tool will be removed in v2.2. Stub returns an error gracefully and does not perform a search.", "description": "DEPRECATED: use get_social_mentions instead. This tool will be removed in v2.2. Stub returns an error gracefully and does not perform a search.", "operationId": "search_web_mentions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "description": "Search query (brand name, keyword, etc)" }, "sources": { "type": "array", "items": { "type": "string" }, "description": "Specific domains to search (optional)" }, "exclude_domains": { "type": "array", "items": { "type": "string" }, "description": "Domains to exclude from results" }, "limit": { "type": "integer", "default": 50, "description": "Maximum results" }, "days_back": { "type": "integer", "default": 30, "description": "Search results from last N days" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_social_mentions": { "post": { "summary": "Aggregates brand mentions across Reddit, YouTube, LinkedIn, Facebook, and Bluesky into a single normalized feed. Each mention includes platform, author, content (truncated to 500 chars), url, posted_at, and sentiment (positive\/negative\/neutral via keyword heuristic). Reddit + YouTube always run via system credentials; LinkedIn\/Facebook\/Bluesky run only when the project has a connected account of that type. Sources fail per-source \u2014 one broken source returns an entry in errors[] but the rest still return. Use this for \"where is my brand mentioned online?\" or \"what are people saying about us this week?\". Replaces deprecated search_web_mentions.", "description": "Aggregates brand mentions across Reddit, YouTube, LinkedIn, Facebook, and Bluesky into a single normalized feed. Each mention includes platform, author, content (truncated to 500 chars), url, posted_at, and sentiment (positive\/negative\/neutral via keyword heuristic). Reddit + YouTube always run via system credentials; LinkedIn\/Facebook\/Bluesky run only when the project has a connected account of that type. Sources fail per-source \u2014 one broken source returns an entry in errors[] but the rest still return. Use this for \"where is my brand mentioned online?\" or \"what are people saying about us this week?\". Replaces deprecated search_web_mentions.", "operationId": "get_social_mentions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "description": "Brand name, hashtag, or keyword to search (e.g. \"IST International School\" or \"ist.ee\")" }, "days": { "type": "integer", "default": 30, "description": "Look-back window in days (1-365)" }, "limit": { "type": "integer", "default": 20, "description": "Max results per source (1-100)" }, "refresh": { "type": "boolean", "default": false, "description": "Bypass all per-source caches for this call" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/scrape_website": { "post": { "summary": "Scrape and extract data from any public website. Can extract text content, meta tags (title, description, OG tags), headings structure, links, and images. Supports JavaScript-rendered pages and custom CSS selectors for specific elements. Use for competitor research, content analysis, price monitoring, or when the user asks to \"check\" or \"look at\" a specific website.", "description": "Scrape and extract data from any public website. Can extract text content, meta tags (title, description, OG tags), headings structure, links, and images. Supports JavaScript-rendered pages and custom CSS selectors for specific elements. Use for competitor research, content analysis, price monitoring, or when the user asks to \"check\" or \"look at\" a specific website.", "operationId": "scrape_website", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL to scrape" }, "extract": { "type": "array", "items": { "type": "string", "enum": [ "text", "links", "images", "meta", "headings", "all" ] }, "default": [ "text", "meta" ], "description": "What to extract from the page" }, "wait_for_selector": { "type": "string", "description": "CSS selector to wait for (for dynamic content)" }, "javascript": { "type": "boolean", "default": true, "description": "Execute JavaScript on page" }, "include_html": { "type": "boolean", "default": false, "description": "Accepted for crawler compatibility. The compact scraper response returns extracted text\/meta\/links\/images, not raw page HTML." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/analyze_competitor_website": { "post": { "summary": "Perform a comprehensive competitor website analysis including site structure, page hierarchy, content themes, technology stack, SEO elements (meta tags, headings, internal linking), and social media presence. Optionally deep-crawl up to 10 pages for a fuller picture. Use when the user wants to \"analyze a competitor\" or understand a competitor's online strategy.", "description": "Perform a comprehensive competitor website analysis including site structure, page hierarchy, content themes, technology stack, SEO elements (meta tags, headings, internal linking), and social media presence. Optionally deep-crawl up to 10 pages for a fuller picture. Use when the user wants to \"analyze a competitor\" or understand a competitor's online strategy.", "operationId": "analyze_competitor_website", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Competitor website URL" }, "deep_crawl": { "type": "boolean", "default": false, "description": "Crawl multiple pages" }, "max_pages": { "type": "integer", "default": 10, "description": "Maximum pages to crawl if deep_crawl is true" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/monitor_keyword_serp": { "post": { "summary": "Check current Google search results (SERP) for specific keywords. Returns top-ranking URLs, titles, and snippets for each keyword. Configurable by location (default: Estonia), language (default: et), and device type. Use for tracking \"where do we rank for keyword X?\" or \"who ranks #1 for this term?\" or competitive SERP analysis.", "description": "Check current Google search results (SERP) for specific keywords. Returns top-ranking URLs, titles, and snippets for each keyword. Configurable by location (default: Estonia), language (default: et), and device type. Use for tracking \"where do we rank for keyword X?\" or \"who ranks #1 for this term?\" or competitive SERP analysis.", "operationId": "monitor_keyword_serp", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "keywords" ], "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Keywords to monitor" }, "location": { "type": "string", "default": "Estonia", "description": "Search location" }, "country": { "type": "string", "description": "Alias for location. ISO country codes such as ee\/est are accepted and normalized before the SERP check." }, "language": { "type": "string", "default": "et", "description": "Search language" }, "device": { "type": "string", "enum": [ "desktop", "mobile" ], "default": "desktop" }, "domain": { "type": "string", "description": "Optional target domain to locate in the SERP; defaults to the project Search Console domain." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_scheduled_report": { "post": { "summary": "Set up an automated recurring marketing report delivered via email. Choose report type (analytics, SEO, social, ads, or comprehensive), frequency (daily\/weekly\/monthly), recipients, and delivery time. The system will automatically gather data and send formatted reports. Use when the user asks to \"schedule reports\" or \"send weekly marketing summaries.\"", "description": "Set up an automated recurring marketing report delivered via email. Choose report type (analytics, SEO, social, ads, or comprehensive), frequency (daily\/weekly\/monthly), recipients, and delivery time. The system will automatically gather data and send formatted reports. Use when the user asks to \"schedule reports\" or \"send weekly marketing summaries.\"", "operationId": "create_scheduled_report", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "report_type", "schedule" ], "properties": { "report_type": { "type": "string", "enum": [ "analytics", "seo", "social", "ads", "comprehensive" ], "description": "Type of report" }, "schedule": { "type": "string", "enum": [ "daily", "weekly", "monthly" ], "description": "Report frequency" }, "recipients": { "type": "array", "items": { "type": "string" }, "description": "Email addresses to send report to" }, "time": { "type": "string", "description": "Time to send (HH:MM)", "default": "09:00" }, "day_of_week": { "type": "integer", "description": "Day of week for weekly reports (0=Sunday, 6=Saturday)" }, "day_of_month": { "type": "integer", "description": "Day of month for monthly reports (1-31)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_alerts": { "post": { "summary": "Retrieve Google Alerts mentions showing where your brand or tracked keywords appeared on the web. Returns source URL, title, date, auto-detected sentiment (positive\/negative\/neutral), and category (News, Blog, Social Media, etc). Filter by sentiment, category, date range, or unread status. Use refresh=true to fetch latest alerts from RSS. Ideal for brand reputation monitoring or PR tracking.", "description": "Retrieve Google Alerts mentions showing where your brand or tracked keywords appeared on the web. Returns source URL, title, date, auto-detected sentiment (positive\/negative\/neutral), and category (News, Blog, Social Media, etc). Filter by sentiment, category, date range, or unread status. Use refresh=true to fetch latest alerts from RSS. Ideal for brand reputation monitoring or PR tracking.", "operationId": "get_google_alerts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of alerts to return" }, "days": { "type": "integer", "description": "Only show alerts from last N days" }, "sentiment": { "type": "string", "enum": [ "positive", "negative", "neutral" ], "description": "Filter by sentiment" }, "category": { "type": "string", "description": "Filter by category (News, Blog, Social Media, etc)" }, "unread_only": { "type": "boolean", "default": false, "description": "Only show unread alerts" }, "refresh": { "type": "boolean", "default": false, "description": "Fetch fresh alerts from RSS before returning" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_activecampaign_contacts": { "post": { "summary": "Get contacts from ActiveCampaign CRM\/email marketing platform with email, name, tags, lists, and engagement score. Filter by email address to find a specific contact.", "description": "Get contacts from ActiveCampaign CRM\/email marketing platform with email, name, tags, lists, and engagement score. Filter by email address to find a specific contact.", "operationId": "get_activecampaign_contacts", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of contacts to return" }, "email": { "type": "string", "description": "Filter by email address" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_activecampaign_deals": { "post": { "summary": "Get deals from ActiveCampaign CRM pipeline with value, stage, contact, and owner. Filter by pipeline stage to focus on specific deal phases.", "description": "Get deals from ActiveCampaign CRM pipeline with value, stage, contact, and owner. Filter by pipeline stage to focus on specific deal phases.", "operationId": "get_activecampaign_deals", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of deals to return" }, "stage": { "type": "string", "description": "Filter by pipeline stage" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_activecampaign_campaigns": { "post": { "summary": "Get email marketing campaigns from ActiveCampaign with name, type, send date, open rate, and click rate. Use for email campaign performance review.", "description": "Get email marketing campaigns from ActiveCampaign with name, type, send date, open rate, and click rate. Use for email campaign performance review.", "operationId": "get_activecampaign_campaigns", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of campaigns to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_activecampaign_automations": { "post": { "summary": "Get marketing automations from ActiveCampaign with name, status (active\/inactive), trigger type, and contact count. Use for reviewing automation workflows.", "description": "Get marketing automations from ActiveCampaign with name, status (active\/inactive), trigger type, and contact count. Use for reviewing automation workflows.", "operationId": "get_activecampaign_automations", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of automations to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_constantcontact_contacts": { "post": { "summary": "Get email subscribers from Constant Contact with email, name, status (active\/unsubscribed\/removed), and list membership. Filter by contact status.", "description": "Get email subscribers from Constant Contact with email, name, status (active\/unsubscribed\/removed), and list membership. Filter by contact status.", "operationId": "get_constantcontact_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of contacts to return" }, "status": { "type": "string", "enum": [ "active", "unsubscribed", "removed" ], "description": "Filter by contact status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_constantcontact_campaigns": { "post": { "summary": "Get email campaigns from Constant Contact with name, status, send date, and performance metrics (opens, clicks, bounces).", "description": "Get email campaigns from Constant Contact with name, status, send date, and performance metrics (opens, clicks, bounces).", "operationId": "get_constantcontact_campaigns", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of campaigns to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_constantcontact_lists": { "post": { "summary": "Get subscriber lists from Constant Contact with list name, description, contact count, and creation date. Use for managing email audiences.", "description": "Get subscriber lists from Constant Contact with list name, description, contact count, and creation date. Use for managing email audiences.", "operationId": "get_constantcontact_lists", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of lists to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_constantcontact_stats": { "post": { "summary": "Get detailed performance analytics for a specific Constant Contact campaign: sends, opens, clicks, bounces, unsubscribes, open rate, and click rate.", "description": "Get detailed performance analytics for a specific Constant Contact campaign: sends, opens, clicks, bounces, unsubscribes, open rate, and click rate.", "operationId": "get_constantcontact_stats", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "campaign_id": { "type": "string", "description": "Campaign ID to get stats for" } }, "required": [ "campaign_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_jotform_forms": { "post": { "summary": "Get online forms from Jotform with form title, creation date, submission count, and status. Use to see what forms are collecting data.", "description": "Get online forms from Jotform with form title, creation date, submission count, and status. Use to see what forms are collecting data.", "operationId": "get_jotform_forms", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of forms to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_jotform_submissions": { "post": { "summary": "Get submitted responses for a specific Jotform form. Returns all field values, submission date, and respondent info. Requires form_id from get_jotform_forms.", "description": "Get submitted responses for a specific Jotform form. Returns all field values, submission date, and respondent info. Requires form_id from get_jotform_forms.", "operationId": "get_jotform_submissions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "form_id": { "type": "string", "description": "Form ID to get submissions for" }, "limit": { "type": "integer", "default": 20, "description": "Number of submissions to return" } }, "required": [ "form_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_buffer_profiles": { "post": { "summary": "List social media profiles connected to Buffer scheduling tool. Returns profile name, platform (Twitter, Facebook, LinkedIn, etc), avatar, and follower count.", "description": "List social media profiles connected to Buffer scheduling tool. Returns profile name, platform (Twitter, Facebook, LinkedIn, etc), avatar, and follower count.", "operationId": "get_buffer_profiles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of profiles to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_buffer_pending_updates": { "post": { "summary": "Get upcoming scheduled social media posts from Buffer queue. Returns post text, scheduled time, media attachments, and target profile. Requires profile_id.", "description": "Get upcoming scheduled social media posts from Buffer queue. Returns post text, scheduled time, media attachments, and target profile. Requires profile_id.", "operationId": "get_buffer_pending_updates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "profile_id": { "type": "string", "description": "Buffer profile ID to get updates for" }, "limit": { "type": "integer", "default": 20, "description": "Number of updates to return" } }, "required": [ "profile_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_buffer_sent_updates": { "post": { "summary": "Get recently published social media posts from Buffer. Returns post text, publish date, engagement stats (likes, shares, comments), and reach. Requires profile_id.", "description": "Get recently published social media posts from Buffer. Returns post text, publish date, engagement stats (likes, shares, comments), and reach. Requires profile_id.", "operationId": "get_buffer_sent_updates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "profile_id": { "type": "string", "description": "Buffer profile ID to get updates for" }, "limit": { "type": "integer", "default": 20, "description": "Number of updates to return" } }, "required": [ "profile_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hootsuite_profiles": { "post": { "summary": "List social media profiles managed in Hootsuite. Returns profile name, platform, handle, and profile picture for each connected account.", "description": "List social media profiles managed in Hootsuite. Returns profile name, platform, handle, and profile picture for each connected account.", "operationId": "get_hootsuite_profiles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of profiles to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hootsuite_messages": { "post": { "summary": "Get social media messages from Hootsuite. Returns post text, state (SENT\/SCHEDULED\/REJECTED), platform, and engagement data. Filter by message state.", "description": "Get social media messages from Hootsuite. Returns post text, state (SENT\/SCHEDULED\/REJECTED), platform, and engagement data. Filter by message state.", "operationId": "get_hootsuite_messages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of messages to return" }, "state": { "type": "string", "enum": [ "SENT", "SCHEDULED", "REJECTED" ], "description": "Filter by message state" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hootsuite_scheduled": { "post": { "summary": "Get upcoming scheduled social media posts in Hootsuite queue. Returns post text, scheduled publish time, target profiles, and media attachments.", "description": "Get upcoming scheduled social media posts in Hootsuite queue. Returns post text, scheduled publish time, target profiles, and media attachments.", "operationId": "get_hootsuite_scheduled", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of scheduled posts to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bluesky_profile": { "post": { "summary": "Get a Bluesky (AT Protocol) user profile with display name, bio, follower\/following counts, and post count. Defaults to the connected account handle.", "description": "Get a Bluesky (AT Protocol) user profile with display name, bio, follower\/following counts, and post count. Defaults to the connected account handle.", "operationId": "get_bluesky_profile", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "handle": { "type": "string", "description": "Bluesky handle (e.g., user.bsky.social). Defaults to connected account." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bluesky_feed": { "post": { "summary": "Get recent posts from a Bluesky account feed. Returns post text, timestamps, like\/repost\/reply counts, and embedded media. Defaults to the connected account.", "description": "Get recent posts from a Bluesky account feed. Returns post text, timestamps, like\/repost\/reply counts, and embedded media. Defaults to the connected account.", "operationId": "get_bluesky_feed", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "handle": { "type": "string", "description": "Bluesky handle to get feed for. Defaults to connected account." }, "limit": { "type": "integer", "default": 20, "description": "Number of posts to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bluesky_notifications": { "post": { "summary": "Get recent Bluesky notifications: likes, reposts, follows, mentions, and replies. Returns notification type, author, timestamp, and related post text.", "description": "Get recent Bluesky notifications: likes, reposts, follows, mentions, and replies. Returns notification type, author, timestamp, and related post text.", "operationId": "get_bluesky_notifications", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of notifications to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bluesky_followers": { "post": { "summary": "List followers of a Bluesky account with display name, handle, bio, and follower count. Defaults to the connected account.", "description": "List followers of a Bluesky account with display name, handle, bio, and follower count. Defaults to the connected account.", "operationId": "get_bluesky_followers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "handle": { "type": "string", "description": "Bluesky handle. Defaults to connected account." }, "limit": { "type": "integer", "default": 20, "description": "Number of followers to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_marketo_leads": { "post": { "summary": "Get leads from Marketo marketing automation with email, name, company, score, and status. Filter by specific field (email, id) and values for targeted lookups.", "description": "Get leads from Marketo marketing automation with email, name, company, score, and status. Filter by specific field (email, id) and values for targeted lookups.", "operationId": "get_marketo_leads", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of leads to return" }, "filter_type": { "type": "string", "description": "Field to filter by (e.g., email, id)" }, "filter_values": { "type": "array", "items": { "type": "string" }, "description": "Values to filter by" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_marketo_campaigns": { "post": { "summary": "Get marketing campaigns from Marketo with name, type, status (active\/inactive), and associated program. Use to review campaign inventory.", "description": "Get marketing campaigns from Marketo with name, type, status (active\/inactive), and associated program. Use to review campaign inventory.", "operationId": "get_marketo_campaigns", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of campaigns to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_marketo_programs": { "post": { "summary": "Get marketing programs from Marketo with name, type (email, event, webinar, nurture), channel, status, and member count.", "description": "Get marketing programs from Marketo with name, type (email, event, webinar, nurture), channel, status, and member count.", "operationId": "get_marketo_programs", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of programs to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_marketo_emails": { "post": { "summary": "Get email templates and assets from Marketo with name, subject line, status (approved\/draft), and folder. Filter by approval status.", "description": "Get email templates and assets from Marketo with name, subject line, status (approved\/draft), and folder. Filter by approval status.", "operationId": "get_marketo_emails", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of emails to return" }, "status": { "type": "string", "enum": [ "approved", "draft" ], "description": "Filter by email status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_posthog_events": { "post": { "summary": "Get tracked events from PostHog product analytics with event name, timestamp, user, and properties. Filter by specific event name for targeted analysis.", "description": "Get tracked events from PostHog product analytics with event name, timestamp, user, and properties. Filter by specific event name for targeted analysis.", "operationId": "get_posthog_events", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of events to return" }, "event": { "type": "string", "description": "Filter by event name" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_posthog_persons": { "post": { "summary": "Get user profiles from PostHog product analytics with properties, first\/last seen dates, and event count. Search by name, email, or distinct ID.", "description": "Get user profiles from PostHog product analytics with properties, first\/last seen dates, and event count. Search by name, email, or distinct ID.", "operationId": "get_posthog_persons", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of persons to return" }, "search": { "type": "string", "description": "Search query for persons" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_posthog_insights": { "post": { "summary": "Get saved insights (charts, funnels, retention reports) from PostHog with name, type, filters, and last computed results.", "description": "Get saved insights (charts, funnels, retention reports) from PostHog with name, type, filters, and last computed results.", "operationId": "get_posthog_insights", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of insights to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_posthog_feature_flags": { "post": { "summary": "Get feature flags from PostHog with name, key, active status, rollout percentage, and targeting filters. Use for feature management review.", "description": "Get feature flags from PostHog with name, key, active status, rollout percentage, and targeting filters. Use for feature management review.", "operationId": "get_posthog_feature_flags", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of feature flags to return" }, "active": { "type": "boolean", "description": "Filter by active status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pendo_guides": { "post": { "summary": "Get in-app guides and walkthroughs from Pendo product analytics. Returns guide name, status (published, draft, disabled), type (tooltip, lightbox, banner), target segment, view\/click counts, and creation date. Use for product adoption tracking or answering \"what in-app guides are active?\", \"show our Pendo walkthroughs\", or \"which guides have the most views?\"", "description": "Get in-app guides and walkthroughs from Pendo product analytics. Returns guide name, status (published, draft, disabled), type (tooltip, lightbox, banner), target segment, view\/click counts, and creation date. Use for product adoption tracking or answering \"what in-app guides are active?\", \"show our Pendo walkthroughs\", or \"which guides have the most views?\"", "operationId": "get_pendo_guides", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of guides to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pendo_features": { "post": { "summary": "Get tracked product features from Pendo analytics. Returns feature name, click count, visitor count, page association, and status. Use for feature adoption analysis or answering \"which features are most used?\", \"show Pendo feature analytics\", or \"what product features do we track?\"", "description": "Get tracked product features from Pendo analytics. Returns feature name, click count, visitor count, page association, and status. Use for feature adoption analysis or answering \"which features are most used?\", \"show Pendo feature analytics\", or \"what product features do we track?\"", "operationId": "get_pendo_features", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of features to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pendo_pages": { "post": { "summary": "Get tracked pages from Pendo product analytics. Returns page name, URL rule, visitor count, pageview count, and average time on page. Use for product usage analysis or answering \"which pages get the most traffic?\", \"show Pendo page analytics\", or \"what pages do users visit most?\"", "description": "Get tracked pages from Pendo product analytics. Returns page name, URL rule, visitor count, pageview count, and average time on page. Use for product usage analysis or answering \"which pages get the most traffic?\", \"show Pendo page analytics\", or \"what pages do users visit most?\"", "operationId": "get_pendo_pages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of pages to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pendo_visitors": { "post": { "summary": "Get visitor\/user data from Pendo product analytics. Returns visitor ID, first\/last visit date, page views, feature clicks, guide interactions, and metadata. Use for user engagement analysis or answering \"who are our most active users?\", \"show Pendo visitor data\", or \"how engaged are our users?\"", "description": "Get visitor\/user data from Pendo product analytics. Returns visitor ID, first\/last visit date, page views, feature clicks, guide interactions, and metadata. Use for user engagement analysis or answering \"who are our most active users?\", \"show Pendo visitor data\", or \"how engaged are our users?\"", "operationId": "get_pendo_visitors", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of visitors to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_surveymonkey_surveys": { "post": { "summary": "List surveys from SurveyMonkey. Returns survey title, ID, status, creation date, response count, and question count. Use for survey management or answering \"what surveys do we have?\", \"show SurveyMonkey surveys\", or \"which surveys have responses?\"", "description": "List surveys from SurveyMonkey. Returns survey title, ID, status, creation date, response count, and question count. Use for survey management or answering \"what surveys do we have?\", \"show SurveyMonkey surveys\", or \"which surveys have responses?\"", "operationId": "get_surveymonkey_surveys", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of surveys to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_surveymonkey_details": { "post": { "summary": "Get full details of a specific SurveyMonkey survey by ID. Returns all pages, questions (with type, choices, required flag), collector settings, and theme. Use for survey review or answering \"what questions are in this survey?\", \"show survey structure\", or \"how is survey X set up?\"", "description": "Get full details of a specific SurveyMonkey survey by ID. Returns all pages, questions (with type, choices, required flag), collector settings, and theme. Use for survey review or answering \"what questions are in this survey?\", \"show survey structure\", or \"how is survey X set up?\"", "operationId": "get_surveymonkey_details", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "survey_id": { "type": "string", "description": "Survey ID to get details for" } }, "required": [ "survey_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_surveymonkey_responses": { "post": { "summary": "Get collected responses for a specific SurveyMonkey survey. Returns individual answers mapped to questions, respondent metadata, completion status, and submission timestamp. Use for survey results analysis or answering \"what did people respond?\", \"show survey results\", or \"analyze survey feedback.\"", "description": "Get collected responses for a specific SurveyMonkey survey. Returns individual answers mapped to questions, respondent metadata, completion status, and submission timestamp. Use for survey results analysis or answering \"what did people respond?\", \"show survey results\", or \"analyze survey feedback.\"", "operationId": "get_surveymonkey_responses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "survey_id": { "type": "string", "description": "Survey ID to get responses for" }, "limit": { "type": "integer", "default": 20, "description": "Number of responses to return" } }, "required": [ "survey_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_integrations": { "post": { "summary": "Browse the full catalog of 70+ available service integrations with authentication type (api_key, oauth, webhook), required credentials, category, and setup instructions. Filter by category (analytics, advertising, social, crm, email_marketing, communication, project_management, ecommerce, payments, etc.) or auth type. Use to discover what services can be connected, or answering \"what integrations are available?\", \"which services support API key auth?\", or \"show me CRM integrations.\"", "description": "Browse the full catalog of 70+ available service integrations with authentication type (api_key, oauth, webhook), required credentials, category, and setup instructions. Filter by category (analytics, advertising, social, crm, email_marketing, communication, project_management, ecommerce, payments, etc.) or auth type. Use to discover what services can be connected, or answering \"what integrations are available?\", \"which services support API key auth?\", or \"show me CRM integrations.\"", "operationId": "list_integrations", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "category": { "type": "string", "description": "Filter by category: analytics, advertising, social, crm, email_marketing, communication, project_management, ecommerce, payments, storage, calendar, email, development, support, cms, accounting, ai, forms, automation" }, "auth_type": { "type": "string", "enum": [ "api_key", "oauth", "webhook" ], "description": "Filter by authentication type" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_connections": { "post": { "summary": "List all currently connected services for this project. Returns each connection's service type, status (connected\/disconnected\/error), connection date, last sync time, and whether it needs configuration. Use for connection health overview or answering \"what services are connected?\", \"show our integrations\", or \"which connections have issues?\"", "description": "List all currently connected services for this project. Returns each connection's service type, status (connected\/disconnected\/error), connection date, last sync time, and whether it needs configuration. Use for connection health overview or answering \"what services are connected?\", \"show our integrations\", or \"which connections have issues?\"", "operationId": "list_connections", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_connection_status": { "post": { "summary": "Check the current connection status and health of a specific integrated service. Returns service status, connection timestamp, and any metadata or configuration details. Use to verify a service is working before querying it, or answering \"is GA4 connected?\", \"check Slack connection\", or \"why isn't Pipedrive working?\"", "description": "Check the current connection status and health of a specific integrated service. Returns service status, connection timestamp, and any metadata or configuration details. Use to verify a service is working before querying it, or answering \"is GA4 connected?\", \"check Slack connection\", or \"why isn't Pipedrive working?\"", "operationId": "get_connection_status", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "service" ], "properties": { "service": { "type": "string", "description": "Service ID (e.g., slack, ga4, github, stripe)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/first_value_status": { "post": { "summary": "Show this project's activation milestones: approved agent, connected data source, first useful non-setup run, and public dashboard. Returns progress, time-to-first-value, the next action, and a suggested prompt without credentials or task results.", "description": "Show this project's activation milestones: approved agent, connected data source, first useful non-setup run, and public dashboard. Returns progress, time-to-first-value, the next action, and a suggested prompt without credentials or task results.", "operationId": "first_value_status", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/inspect_runs": { "post": { "summary": "Inspect failed and stalled A2A tool runs for this project. Returns sanitized root-cause categories and recommended actions without task inputs, raw results, credentials, callback URLs, IPs, or automatic replay. Pass task_id for one run.", "description": "Inspect failed and stalled A2A tool runs for this project. Returns sanitized root-cause categories and recommended actions without task inputs, raw results, credentials, callback URLs, IPs, or automatic replay. Pass task_id for one run.", "operationId": "inspect_runs", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "task_id": { "type": "string", "description": "Optional exact A2A task ID for one project-scoped run." }, "days": { "type": "integer", "default": 7, "minimum": 1, "maximum": 30 }, "limit": { "type": "integer", "default": 50, "minimum": 1, "maximum": 100 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/diagnose_connections": { "post": { "summary": "Run Connection Doctor for this project. Classifies missing configuration, expired authorization, temporary provider failures, and healthy connections without exposing credentials. Set live=true for bounded read-only provider checks.", "description": "Run Connection Doctor for this project. Classifies missing configuration, expired authorization, temporary provider failures, and healthy connections without exposing credentials. Set live=true for bounded read-only provider checks.", "operationId": "diagnose_connections", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "service": { "type": "string", "description": "Optional service ID. Omit to diagnose every project connection." }, "live": { "type": "boolean", "default": false, "description": "Run a bounded read-only provider check when supported." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/repair_connection": { "post": { "summary": "Safely retry one connection with a bounded read-only live check. Marks it connected only after verified success, never deletes or rotates credentials, and preserves status on temporary or unsupported failures.", "description": "Safely retry one connection with a bounded read-only live check. Marks it connected only after verified success, never deletes or rotates credentials, and preserves status on temporary or unsupported failures.", "operationId": "repair_connection", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "service" ], "properties": { "service": { "type": "string", "description": "Service ID to retry." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/connect_service": { "post": { "summary": "Connect a new service by providing API key credentials. Only works for services with auth type \"api_key\" \u2014 for OAuth services, users must initiate the flow from the web interface. Validates credentials, creates the connection, and returns success status. Use when the user provides an API key and wants to set up a new integration, or answering \"connect Slack with this API key\" or \"set up Stripe.\"", "description": "Connect a new service by providing API key credentials. Only works for services with auth type \"api_key\" \u2014 for OAuth services, users must initiate the flow from the web interface. Validates credentials, creates the connection, and returns success status. Use when the user provides an API key and wants to set up a new integration, or answering \"connect Slack with this API key\" or \"set up Stripe.\"", "operationId": "connect_service", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "service", "credentials" ], "properties": { "service": { "type": "string", "description": "Service ID from integrations catalog (e.g., slack, github, stripe)" }, "credentials": { "type": "object", "description": "Service-specific credentials. Use list_integrations to see required fields for each service." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/disconnect_service": { "post": { "summary": "Disconnect an integrated service and remove its stored credentials. This is irreversible \u2014 the service will need to be reconnected with fresh credentials. Use when asked to \"disconnect Slack\", \"remove the GA4 integration\", or \"unlink Pipedrive.\"", "description": "Disconnect an integrated service and remove its stored credentials. This is irreversible \u2014 the service will need to be reconnected with fresh credentials. Use when asked to \"disconnect Slack\", \"remove the GA4 integration\", or \"unlink Pipedrive.\"", "operationId": "disconnect_service", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "service" ], "properties": { "service": { "type": "string", "description": "Service ID to disconnect" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/configure_connection": { "post": { "summary": "Update configuration settings for an already-connected service \u2014 for example, setting the GA4 property_id, GSC site_url, or Slack channel preferences. Does not change credentials, only configuration metadata. Use when asked \"set our GA4 property to 123456\", \"configure GSC site URL\", or \"update the connection settings.\"", "description": "Update configuration settings for an already-connected service \u2014 for example, setting the GA4 property_id, GSC site_url, or Slack channel preferences. Does not change credentials, only configuration metadata. Use when asked \"set our GA4 property to 123456\", \"configure GSC site URL\", or \"update the connection settings.\"", "operationId": "configure_connection", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "service", "config" ], "properties": { "service": { "type": "string", "description": "Service ID" }, "config": { "type": "object", "description": "Configuration key-value pairs (e.g., {\"property_id\": \"123456\"} for GA4)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_forms": { "post": { "summary": "List all Google Forms accessible by the connected Google account. Returns form title, ID, description, and URL. Use to discover available forms or answering \"what Google Forms do we have?\" or \"show our survey forms.\"", "description": "List all Google Forms accessible by the connected Google account. Returns form title, ID, description, and URL. Use to discover available forms or answering \"what Google Forms do we have?\" or \"show our survey forms.\"", "operationId": "get_google_forms", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of forms to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_form": { "post": { "summary": "Get the full structure of a specific Google Form by ID \u2014 including all questions (with type, options, required flag), description, and form settings. Use for form review or answering \"what questions are in this form?\" or \"show me the form details.\"", "description": "Get the full structure of a specific Google Form by ID \u2014 including all questions (with type, options, required flag), description, and form settings. Use for form review or answering \"what questions are in this form?\" or \"show me the form details.\"", "operationId": "get_google_form", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "form_id" ], "properties": { "form_id": { "type": "string", "description": "Google Form ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_form_responses": { "post": { "summary": "Retrieve submitted responses for a specific Google Form. Returns each response with answers mapped to questions, submission timestamp, and respondent email (if collected). Use for survey analysis or answering \"what responses did we get?\", \"how many people filled out the form?\", or \"show form results.\"", "description": "Retrieve submitted responses for a specific Google Form. Returns each response with answers mapped to questions, submission timestamp, and respondent email (if collected). Use for survey analysis or answering \"what responses did we get?\", \"how many people filled out the form?\", or \"show form results.\"", "operationId": "get_google_form_responses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "form_id" ], "properties": { "form_id": { "type": "string", "description": "Google Form ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of responses to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_chat_spaces": { "post": { "summary": "List Google Chat spaces (group rooms and DMs) accessible by the connected account. Returns space name, type, member count, and ID. Use to discover available chat rooms or answering \"what Google Chat rooms are there?\" or \"list our team spaces.\"", "description": "List Google Chat spaces (group rooms and DMs) accessible by the connected account. Returns space name, type, member count, and ID. Use to discover available chat rooms or answering \"what Google Chat rooms are there?\" or \"list our team spaces.\"", "operationId": "get_google_chat_spaces", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of spaces to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_google_chat_messages": { "post": { "summary": "Retrieve messages from a specific Google Chat space. Returns message text, sender, timestamp, and thread information. Use for reading team conversations or answering \"what messages are in this chat room?\" or \"show recent Google Chat messages.\"", "description": "Retrieve messages from a specific Google Chat space. Returns message text, sender, timestamp, and thread information. Use for reading team conversations or answering \"what messages are in this chat room?\" or \"show recent Google Chat messages.\"", "operationId": "get_google_chat_messages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "space_id" ], "properties": { "space_id": { "type": "string", "description": "Google Chat space ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of messages to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_google_chat_message": { "post": { "summary": "Send a text message to a Google Chat space, optionally as a reply to an existing thread. Use when asked to \"post a message to Google Chat\", \"send an update to the team room\", or \"reply to this chat thread.\"", "description": "Send a text message to a Google Chat space, optionally as a reply to an existing thread. Use when asked to \"post a message to Google Chat\", \"send an update to the team room\", or \"reply to this chat thread.\"", "operationId": "send_google_chat_message", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "space_id", "text" ], "properties": { "space_id": { "type": "string", "description": "Google Chat space ID" }, "text": { "type": "string", "description": "Message text to send" }, "thread_id": { "type": "string", "description": "Thread ID to reply to (optional)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_basecamp_projects": { "post": { "summary": "List projects from Basecamp project management. Returns project name, description, status (active\/archived\/trashed), creator, and member count. Filter by status. Use for project overview or answering \"what Basecamp projects do we have?\" or \"show active projects.\"", "description": "List projects from Basecamp project management. Returns project name, description, status (active\/archived\/trashed), creator, and member count. Filter by status. Use for project overview or answering \"what Basecamp projects do we have?\" or \"show active projects.\"", "operationId": "get_basecamp_projects", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of projects to return" }, "status": { "type": "string", "enum": [ "active", "archived", "trashed" ], "description": "Filter by project status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_basecamp_todolists": { "post": { "summary": "Get to-do lists within a specific Basecamp project. Returns list name, description, completed\/remaining counts, and assignees. Use for task planning or answering \"what to-do lists are in this project?\" or \"show our Basecamp task lists.\"", "description": "Get to-do lists within a specific Basecamp project. Returns list name, description, completed\/remaining counts, and assignees. Use for task planning or answering \"what to-do lists are in this project?\" or \"show our Basecamp task lists.\"", "operationId": "get_basecamp_todolists", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "project_id" ], "properties": { "project_id": { "type": "string", "description": "Basecamp project ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of to-do lists to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_basecamp_todos": { "post": { "summary": "Get individual to-do items from a Basecamp to-do list. Returns task title, description, assignee, due date, completion status, and priority. Filter by completed\/incomplete. Use for task tracking or answering \"what tasks are pending?\", \"who is assigned to what?\", or \"show completed todos.\"", "description": "Get individual to-do items from a Basecamp to-do list. Returns task title, description, assignee, due date, completion status, and priority. Filter by completed\/incomplete. Use for task tracking or answering \"what tasks are pending?\", \"who is assigned to what?\", or \"show completed todos.\"", "operationId": "get_basecamp_todos", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "project_id", "todolist_id" ], "properties": { "project_id": { "type": "string", "description": "Basecamp project ID" }, "todolist_id": { "type": "string", "description": "Basecamp to-do list ID" }, "completed": { "type": "boolean", "description": "Filter by completion status" }, "limit": { "type": "integer", "default": 20, "description": "Number of to-dos to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wrike_tasks": { "post": { "summary": "Get tasks from Wrike project management. Returns task title, status (Active, Completed, Deferred, Cancelled), assignees, due dates, importance, and parent folder. Filter by status or folder. Use for task tracking or answering \"what Wrike tasks are active?\", \"show overdue tasks\", or \"what is assigned to me?\"", "description": "Get tasks from Wrike project management. Returns task title, status (Active, Completed, Deferred, Cancelled), assignees, due dates, importance, and parent folder. Filter by status or folder. Use for task tracking or answering \"what Wrike tasks are active?\", \"show overdue tasks\", or \"what is assigned to me?\"", "operationId": "get_wrike_tasks", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of tasks to return" }, "status": { "type": "string", "enum": [ "Active", "Completed", "Deferred", "Cancelled" ], "description": "Filter by task status" }, "folder_id": { "type": "string", "description": "Filter by folder\/project ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wrike_folders": { "post": { "summary": "Get folder structure from Wrike workspace. Returns folder name, ID, parent, child count, and sharing info. Use for navigating the project hierarchy or answering \"show our Wrike folder structure\" or \"list project folders.\"", "description": "Get folder structure from Wrike workspace. Returns folder name, ID, parent, child count, and sharing info. Use for navigating the project hierarchy or answering \"show our Wrike folder structure\" or \"list project folders.\"", "operationId": "get_wrike_folders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of folders to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wrike_projects": { "post": { "summary": "Get projects from Wrike workspace. Returns project name, status, owner, dates, and custom fields. Use for project overview or answering \"what Wrike projects do we have?\" or \"show project status.\"", "description": "Get projects from Wrike workspace. Returns project name, status, owner, dates, and custom fields. Use for project overview or answering \"what Wrike projects do we have?\" or \"show project status.\"", "operationId": "get_wrike_projects", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of projects to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bigcommerce_products": { "post": { "summary": "Get products from BigCommerce online store. Returns product name, SKU, price, inventory level, categories, images, and status. Search by keyword. Use for product catalog review or answering \"what products do we sell?\", \"check inventory levels\", or \"find product by name.\"", "description": "Get products from BigCommerce online store. Returns product name, SKU, price, inventory level, categories, images, and status. Search by keyword. Use for product catalog review or answering \"what products do we sell?\", \"check inventory levels\", or \"find product by name.\"", "operationId": "get_bigcommerce_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of products to return" }, "keyword": { "type": "string", "description": "Search products by keyword" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bigcommerce_orders": { "post": { "summary": "Get orders from BigCommerce online store. Returns order number, customer, items, total amount, status, shipping address, and dates. Filter by order status. Use for order tracking or answering \"show recent orders\", \"how many orders today?\", or \"find orders with status X.\"", "description": "Get orders from BigCommerce online store. Returns order number, customer, items, total amount, status, shipping address, and dates. Filter by order status. Use for order tracking or answering \"show recent orders\", \"how many orders today?\", or \"find orders with status X.\"", "operationId": "get_bigcommerce_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of orders to return" }, "status": { "type": "string", "description": "Filter by order status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bigcommerce_customers": { "post": { "summary": "Get customer records from BigCommerce store. Returns customer name, email, phone, address, order count, and total spent. Filter by email. Use for customer lookups or answering \"find customer by email\", \"who are our top customers?\", or \"show customer details.\"", "description": "Get customer records from BigCommerce store. Returns customer name, email, phone, address, order count, and total spent. Filter by email. Use for customer lookups or answering \"find customer by email\", \"who are our top customers?\", or \"show customer details.\"", "operationId": "get_bigcommerce_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of customers to return" }, "email": { "type": "string", "description": "Filter by email address" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_acuity_appointments": { "post": { "summary": "Get appointments from Acuity Scheduling. Returns appointment date\/time, client name, service type, duration, status, and notes. Filter by date range. Use for schedule review or answering \"what appointments are coming up?\", \"show today's schedule\", or \"list bookings this week.\"", "description": "Get appointments from Acuity Scheduling. Returns appointment date\/time, client name, service type, duration, status, and notes. Filter by date range. Use for schedule review or answering \"what appointments are coming up?\", \"show today's schedule\", or \"list bookings this week.\"", "operationId": "get_acuity_appointments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of appointments to return" }, "min_date": { "type": "string", "description": "Filter appointments from this date (YYYY-MM-DD)" }, "max_date": { "type": "string", "description": "Filter appointments until this date (YYYY-MM-DD)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_acuity_clients": { "post": { "summary": "Get client records from Acuity Scheduling. Returns client name, email, phone, appointment history count, and notes. Search by name or email. Use for client lookups or answering \"find a client\", \"who are our scheduling clients?\", or \"show client details.\"", "description": "Get client records from Acuity Scheduling. Returns client name, email, phone, appointment history count, and notes. Search by name or email. Use for client lookups or answering \"find a client\", \"who are our scheduling clients?\", or \"show client details.\"", "operationId": "get_acuity_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of clients to return" }, "search": { "type": "string", "description": "Search clients by name or email" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_acuity_calendars": { "post": { "summary": "Get calendars\/staff schedules from Acuity Scheduling. Returns calendar name, timezone, and availability info. Use for staff scheduling overview or answering \"show our calendars\" or \"which scheduling calendars do we have?\"", "description": "Get calendars\/staff schedules from Acuity Scheduling. Returns calendar name, timezone, and availability info. Use for staff scheduling overview or answering \"show our calendars\" or \"which scheduling calendars do we have?\"", "operationId": "get_acuity_calendars", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of calendars to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_calcom_bookings": { "post": { "summary": "Get bookings from Cal.com scheduling platform. Returns booking title, attendee, date\/time, status (upcoming, past, cancelled), event type, and meeting link. Filter by status. Use for meeting tracking or answering \"what bookings do we have?\", \"show upcoming meetings\", or \"list cancelled bookings.\"", "description": "Get bookings from Cal.com scheduling platform. Returns booking title, attendee, date\/time, status (upcoming, past, cancelled), event type, and meeting link. Filter by status. Use for meeting tracking or answering \"what bookings do we have?\", \"show upcoming meetings\", or \"list cancelled bookings.\"", "operationId": "get_calcom_bookings", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of bookings to return" }, "status": { "type": "string", "enum": [ "upcoming", "past", "cancelled" ], "description": "Filter by booking status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_calcom_event_types": { "post": { "summary": "Get event types configured in Cal.com \u2014 the different meeting types available for booking (e.g., \"30 min call\", \"Product demo\"). Returns event name, duration, description, price, and booking URL. Use for understanding scheduling options or answering \"what meeting types do we offer?\" or \"show our Cal.com event types.\"", "description": "Get event types configured in Cal.com \u2014 the different meeting types available for booking (e.g., \"30 min call\", \"Product demo\"). Returns event name, duration, description, price, and booking URL. Use for understanding scheduling options or answering \"what meeting types do we offer?\" or \"show our Cal.com event types.\"", "operationId": "get_calcom_event_types", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of event types to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_calcom_schedules": { "post": { "summary": "Get availability schedules from Cal.com defining when bookings can be made. Returns schedule name, timezone, and time slots per day. Use for availability management or answering \"when are we available for bookings?\" or \"show our scheduling availability.\"", "description": "Get availability schedules from Cal.com defining when bookings can be made. Returns schedule name, timezone, and time slots per day. Use for availability management or answering \"when are we available for bookings?\" or \"show our scheduling availability.\"", "operationId": "get_calcom_schedules", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of schedules to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_deel_contracts": { "post": { "summary": "Get contractor\/employee contracts from Deel global HR and payroll platform. Returns contract title, worker name, type (contractor\/employee), status (active, in_progress, cancelled), start date, compensation, and currency. Filter by status. Use for team management or answering \"who are our contractors?\", \"show active Deel contracts\", or \"what employees are on Deel?\"", "description": "Get contractor\/employee contracts from Deel global HR and payroll platform. Returns contract title, worker name, type (contractor\/employee), status (active, in_progress, cancelled), start date, compensation, and currency. Filter by status. Use for team management or answering \"who are our contractors?\", \"show active Deel contracts\", or \"what employees are on Deel?\"", "operationId": "get_deel_contracts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of contracts to return" }, "status": { "type": "string", "enum": [ "active", "in_progress", "cancelled" ], "description": "Filter by contract status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_deel_invoices": { "post": { "summary": "Get invoices from Deel for contractor payments and services. Returns invoice amount, currency, status, contractor name, and payment date. Use for payroll tracking or answering \"what Deel invoices are pending?\", \"show contractor payment history\", or \"how much have we paid through Deel?\"", "description": "Get invoices from Deel for contractor payments and services. Returns invoice amount, currency, status, contractor name, and payment date. Use for payroll tracking or answering \"what Deel invoices are pending?\", \"show contractor payment history\", or \"how much have we paid through Deel?\"", "operationId": "get_deel_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of invoices to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_deel_people": { "post": { "summary": "Get people (workers and employees) managed through Deel. Returns person name, email, role, contract type, country, and status. Use for team overview or answering \"who is on our Deel team?\", \"list our remote workers\", or \"how many contractors do we have?\"", "description": "Get people (workers and employees) managed through Deel. Returns person name, email, role, contract type, country, and status. Use for team overview or answering \"who is on our Deel team?\", \"list our remote workers\", or \"how many contractors do we have?\"", "operationId": "get_deel_people", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of people to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_deel_payments": { "post": { "summary": "Get payment records from Deel for contractor and employee payouts. Returns payment amount, currency, recipient, status, and date. Use for payroll tracking or answering \"what payments have been made through Deel?\", \"show recent payroll\", or \"check payment status.\"", "description": "Get payment records from Deel for contractor and employee payouts. Returns payment amount, currency, recipient, status, and date. Use for payroll tracking or answering \"what payments have been made through Deel?\", \"show recent payroll\", or \"check payment status.\"", "operationId": "get_deel_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of payments to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_greenhouse_candidates": { "post": { "summary": "Get candidates from Greenhouse Applicant Tracking System (ATS). Returns candidate name, email, phone, applied jobs, current stage, source, and recruiter. Filter by job ID. Use for recruitment tracking or answering \"who are our candidates?\", \"show applicants for this role\", or \"how many candidates applied?\"", "description": "Get candidates from Greenhouse Applicant Tracking System (ATS). Returns candidate name, email, phone, applied jobs, current stage, source, and recruiter. Filter by job ID. Use for recruitment tracking or answering \"who are our candidates?\", \"show applicants for this role\", or \"how many candidates applied?\"", "operationId": "get_greenhouse_candidates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of candidates to return" }, "job_id": { "type": "string", "description": "Filter candidates by job ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_greenhouse_jobs": { "post": { "summary": "Get open positions\/job postings from Greenhouse ATS. Returns job title, department, location, status (open, closed, draft), hiring manager, and candidate count. Filter by status. Use for recruitment overview or answering \"what positions are open?\", \"show all jobs\", or \"which roles are we hiring for?\"", "description": "Get open positions\/job postings from Greenhouse ATS. Returns job title, department, location, status (open, closed, draft), hiring manager, and candidate count. Filter by status. Use for recruitment overview or answering \"what positions are open?\", \"show all jobs\", or \"which roles are we hiring for?\"", "operationId": "get_greenhouse_jobs", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of jobs to return" }, "status": { "type": "string", "enum": [ "open", "closed", "draft" ], "description": "Filter by job status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_greenhouse_applications": { "post": { "summary": "Get job applications from Greenhouse ATS. Returns applicant name, applied job, current stage, status (active, rejected, hired), source, and submission date. Filter by job ID or status. Use for pipeline tracking or answering \"show applications for this role\", \"who was rejected?\", or \"how many active applications?\"", "description": "Get job applications from Greenhouse ATS. Returns applicant name, applied job, current stage, status (active, rejected, hired), source, and submission date. Filter by job ID or status. Use for pipeline tracking or answering \"show applications for this role\", \"who was rejected?\", or \"how many active applications?\"", "operationId": "get_greenhouse_applications", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of applications to return" }, "job_id": { "type": "string", "description": "Filter applications by job ID" }, "status": { "type": "string", "enum": [ "active", "rejected", "hired" ], "description": "Filter by application status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_greenhouse_offers": { "post": { "summary": "Get employment offers from Greenhouse ATS. Returns offer details, candidate name, job, status (unresolved, accepted, rejected, deprecated), salary, and start date. Filter by status. Use for offer tracking or answering \"what offers are pending?\", \"who accepted their offer?\", or \"show rejected offers.\"", "description": "Get employment offers from Greenhouse ATS. Returns offer details, candidate name, job, status (unresolved, accepted, rejected, deprecated), salary, and start date. Filter by status. Use for offer tracking or answering \"what offers are pending?\", \"who accepted their offer?\", or \"show rejected offers.\"", "operationId": "get_greenhouse_offers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of offers to return" }, "status": { "type": "string", "enum": [ "unresolved", "accepted", "rejected", "deprecated" ], "description": "Filter by offer status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_resend_emails": { "post": { "summary": "Get sent transactional emails from Resend email delivery platform. Returns email subject, recipients, status, sent date, and delivery info. Use for email delivery monitoring or answering \"what emails were sent via Resend?\", \"check email delivery status\", or \"show recent sent emails.\"", "description": "Get sent transactional emails from Resend email delivery platform. Returns email subject, recipients, status, sent date, and delivery info. Use for email delivery monitoring or answering \"what emails were sent via Resend?\", \"check email delivery status\", or \"show recent sent emails.\"", "operationId": "get_resend_emails", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of emails to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_resend_domains": { "post": { "summary": "Get configured sending domains from Resend. Returns domain name, verification status, DNS records, and creation date. Use for domain management or answering \"what domains are set up in Resend?\", \"is our domain verified?\", or \"check email sending domain status.\"", "description": "Get configured sending domains from Resend. Returns domain name, verification status, DNS records, and creation date. Use for domain management or answering \"what domains are set up in Resend?\", \"is our domain verified?\", or \"check email sending domain status.\"", "operationId": "get_resend_domains", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of domains to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_resend_email": { "post": { "summary": "Send a transactional email via Resend email platform. Requires sender address (must be from a verified domain), recipient(s), subject, and HTML or plain text body. Use when asked to \"send a transactional email\", \"email this notification via Resend\", or \"send a confirmation email.\"", "description": "Send a transactional email via Resend email platform. Requires sender address (must be from a verified domain), recipient(s), subject, and HTML or plain text body. Use when asked to \"send a transactional email\", \"email this notification via Resend\", or \"send a confirmation email.\"", "operationId": "send_resend_email", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "from", "to", "subject" ], "properties": { "from": { "type": "string", "description": "Sender email address" }, "to": { "type": "array", "items": { "type": "string" }, "description": "Recipient email addresses" }, "subject": { "type": "string", "description": "Email subject" }, "html": { "type": "string", "description": "HTML email body" }, "text": { "type": "string", "description": "Plain text email body" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tableau_workbooks": { "post": { "summary": "Get workbooks from Tableau data visualization platform. Returns workbook name, project, owner, creation date, and view count. Use for BI content discovery or answering \"what Tableau workbooks do we have?\", \"show our dashboards\", or \"list analytics reports.\"", "description": "Get workbooks from Tableau data visualization platform. Returns workbook name, project, owner, creation date, and view count. Use for BI content discovery or answering \"what Tableau workbooks do we have?\", \"show our dashboards\", or \"list analytics reports.\"", "operationId": "get_tableau_workbooks", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of workbooks to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tableau_views": { "post": { "summary": "Get views (dashboards and sheets) from Tableau. Returns view name, workbook, owner, URL, and usage stats. Filter by workbook ID. Use for finding specific dashboards or answering \"what views are in this workbook?\", \"show available Tableau dashboards\", or \"find a specific report.\"", "description": "Get views (dashboards and sheets) from Tableau. Returns view name, workbook, owner, URL, and usage stats. Filter by workbook ID. Use for finding specific dashboards or answering \"what views are in this workbook?\", \"show available Tableau dashboards\", or \"find a specific report.\"", "operationId": "get_tableau_views", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of views to return" }, "workbook_id": { "type": "string", "description": "Filter views by workbook ID" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tableau_datasources": { "post": { "summary": "Get data sources configured in Tableau. Returns data source name, type, connection info, owner, and last update. Use for data inventory or answering \"what data sources does Tableau use?\", \"show our connected databases\", or \"check data source status.\"", "description": "Get data sources configured in Tableau. Returns data source name, type, connection info, owner, and last update. Use for data inventory or answering \"what data sources does Tableau use?\", \"show our connected databases\", or \"check data source status.\"", "operationId": "get_tableau_datasources", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of data sources to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_looker_dashboards": { "post": { "summary": "Get dashboards from Looker BI platform. Returns dashboard title, description, folder, element count, and last viewed date. Use for BI content discovery or answering \"what Looker dashboards do we have?\", \"show analytics dashboards\", or \"list our reports.\"", "description": "Get dashboards from Looker BI platform. Returns dashboard title, description, folder, element count, and last viewed date. Use for BI content discovery or answering \"what Looker dashboards do we have?\", \"show analytics dashboards\", or \"list our reports.\"", "operationId": "get_looker_dashboards", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of dashboards to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_looker_looks": { "post": { "summary": "Get Looks (saved queries and visualizations) from Looker. Returns look title, description, query details, folder, and last run date. Use for finding saved analyses or answering \"what Looks do we have?\", \"show saved queries\", or \"find a specific report.\"", "description": "Get Looks (saved queries and visualizations) from Looker. Returns look title, description, query details, folder, and last run date. Use for finding saved analyses or answering \"what Looks do we have?\", \"show saved queries\", or \"find a specific report.\"", "operationId": "get_looker_looks", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of looks to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_looker_folders": { "post": { "summary": "Get folder structure from Looker for organizing dashboards and Looks. Returns folder name, parent, child count, and content summary. Use for navigating BI content or answering \"show Looker folder structure\" or \"where are our dashboards organized?\"", "description": "Get folder structure from Looker for organizing dashboards and Looks. Returns folder name, parent, child count, and content summary. Use for navigating BI content or answering \"show Looker folder structure\" or \"where are our dashboards organized?\"", "operationId": "get_looker_folders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of folders to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/snowflake_query": { "post": { "summary": "Execute a SQL query against Snowflake cloud data warehouse and return results. Returns query results as rows with column names, limited to a configurable max rows (default 100). Use for ad-hoc data analysis, reporting queries, or answering \"run this SQL query\", \"how many rows in table X?\", or \"get data from Snowflake.\"", "description": "Execute a SQL query against Snowflake cloud data warehouse and return results. Returns query results as rows with column names, limited to a configurable max rows (default 100). Use for ad-hoc data analysis, reporting queries, or answering \"run this SQL query\", \"how many rows in table X?\", or \"get data from Snowflake.\"", "operationId": "snowflake_query", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "description": "SQL query to execute" }, "limit": { "type": "integer", "default": 100, "description": "Maximum rows to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_snowflake_databases": { "post": { "summary": "List available databases in the Snowflake data warehouse. Returns database name, owner, creation date, and schema count. Use for data discovery or answering \"what databases are in Snowflake?\", \"show available data\", or \"list our data warehouse databases.\"", "description": "List available databases in the Snowflake data warehouse. Returns database name, owner, creation date, and schema count. Use for data discovery or answering \"what databases are in Snowflake?\", \"show available data\", or \"list our data warehouse databases.\"", "operationId": "get_snowflake_databases", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of databases to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_snowflake_tables": { "post": { "summary": "List tables within a specific Snowflake database and schema. Returns table name, row count, size, column count, and last modified date. Use for schema exploration or answering \"what tables are in this database?\", \"show table structure\", or \"list tables in the PUBLIC schema.\"", "description": "List tables within a specific Snowflake database and schema. Returns table name, row count, size, column count, and last modified date. Use for schema exploration or answering \"what tables are in this database?\", \"show table structure\", or \"list tables in the PUBLIC schema.\"", "operationId": "get_snowflake_tables", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "database": { "type": "string", "description": "Database name" }, "schema": { "type": "string", "default": "PUBLIC", "description": "Schema name" }, "limit": { "type": "integer", "default": 20, "description": "Number of tables to return" } }, "required": [ "database" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_azuredevops_projects": { "post": { "summary": "Get projects from Azure DevOps. Returns project name, description, state, revision, and URL. Use for project discovery or answering \"what Azure DevOps projects do we have?\" or \"show our DevOps projects.\"", "description": "Get projects from Azure DevOps. Returns project name, description, state, revision, and URL. Use for project discovery or answering \"what Azure DevOps projects do we have?\" or \"show our DevOps projects.\"", "operationId": "get_azuredevops_projects", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of projects to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_azuredevops_work_items": { "post": { "summary": "Get work items (bugs, tasks, user stories, features, epics) from Azure DevOps. Returns work item title, type, state (Active, Closed, New), assigned to, priority, and iteration. Filter by project, type, or state. Use for sprint tracking or answering \"what bugs are open?\", \"show active tasks\", or \"list user stories for this sprint.\"", "description": "Get work items (bugs, tasks, user stories, features, epics) from Azure DevOps. Returns work item title, type, state (Active, Closed, New), assigned to, priority, and iteration. Filter by project, type, or state. Use for sprint tracking or answering \"what bugs are open?\", \"show active tasks\", or \"list user stories for this sprint.\"", "operationId": "get_azuredevops_work_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "project": { "type": "string", "description": "Project name or ID" }, "type": { "type": "string", "enum": [ "Bug", "Task", "User Story", "Feature", "Epic" ], "description": "Filter by work item type" }, "state": { "type": "string", "description": "Filter by state (e.g., Active, Closed, New)" }, "limit": { "type": "integer", "default": 20, "description": "Number of work items to return" } }, "required": [ "project" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_azuredevops_repos": { "post": { "summary": "Get Git repositories from Azure DevOps. Returns repo name, URL, default branch, size, and last commit info. Use for code repository overview or answering \"what repos do we have in Azure DevOps?\", \"show our code repositories\", or \"list project repos.\"", "description": "Get Git repositories from Azure DevOps. Returns repo name, URL, default branch, size, and last commit info. Use for code repository overview or answering \"what repos do we have in Azure DevOps?\", \"show our code repositories\", or \"list project repos.\"", "operationId": "get_azuredevops_repos", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "project": { "type": "string", "description": "Project name or ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of repositories to return" } }, "required": [ "project" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_azuredevops_pipelines": { "post": { "summary": "Get CI\/CD pipelines from Azure DevOps. Returns pipeline name, folder, configuration type, and last run status. Use for DevOps overview or answering \"what pipelines do we have?\", \"show our CI\/CD setup\", or \"list build pipelines.\"", "description": "Get CI\/CD pipelines from Azure DevOps. Returns pipeline name, folder, configuration type, and last run status. Use for DevOps overview or answering \"what pipelines do we have?\", \"show our CI\/CD setup\", or \"list build pipelines.\"", "operationId": "get_azuredevops_pipelines", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "project": { "type": "string", "description": "Project name or ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of pipelines to return" } }, "required": [ "project" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wise_balances": { "post": { "summary": "Retrieve real-time Wise (TransferWise) multi-currency account balances. Returns each currency account with available amount, formatted balance, and profile info (personal or business). Use for treasury overview, cash position checks, or answering \"how much money do we have in Wise?\", \"what is our EUR balance?\", or \"show all currency accounts.\"", "description": "Retrieve real-time Wise (TransferWise) multi-currency account balances. Returns each currency account with available amount, formatted balance, and profile info (personal or business). Use for treasury overview, cash position checks, or answering \"how much money do we have in Wise?\", \"what is our EUR balance?\", or \"show all currency accounts.\"", "operationId": "get_wise_balances", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "profile_type": { "type": "string", "enum": [ "personal", "business" ], "description": "Which profile to query (default: first available)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wise_profiles": { "post": { "summary": "List all Wise account profiles \u2014 both personal and business. Returns profile ID, type (PERSONAL\/BUSINESS), and holder name. Needed to identify which profile to query for balances or transfers. Use when asked \"which Wise accounts do we have?\" or before querying specific profile data.", "description": "List all Wise account profiles \u2014 both personal and business. Returns profile ID, type (PERSONAL\/BUSINESS), and holder name. Needed to identify which profile to query for balances or transfers. Use when asked \"which Wise accounts do we have?\" or before querying specific profile data.", "operationId": "get_wise_profiles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wise_transfers": { "post": { "summary": "Get recent international transfers and payments from Wise. Returns transfer amount, source\/target currency, recipient details, status (incoming_payment_waiting, processing, funds_converted, outgoing_payment_sent, bounced_back), and creation date. Filter by profile type. Use for payment tracking or answering \"what transfers have we made?\", \"show recent Wise payments\", or \"did the transfer to X go through?\"", "description": "Get recent international transfers and payments from Wise. Returns transfer amount, source\/target currency, recipient details, status (incoming_payment_waiting, processing, funds_converted, outgoing_payment_sent, bounced_back), and creation date. Filter by profile type. Use for payment tracking or answering \"what transfers have we made?\", \"show recent Wise payments\", or \"did the transfer to X go through?\"", "operationId": "get_wise_transfers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Number of transfers to return (default: 10, max: 50)" }, "profile_type": { "type": "string", "enum": [ "personal", "business" ], "description": "Which profile to query (default: first available)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wise_exchange_rate": { "post": { "summary": "Get the current mid-market exchange rate from Wise between any two currencies. Returns the live rate with source and target currency codes. Wise rates are typically very close to the real mid-market rate. Use for currency conversion questions like \"what is the EUR to USD rate?\", \"how much is 1000 GBP in EUR?\", or comparing rates before making transfers.", "description": "Get the current mid-market exchange rate from Wise between any two currencies. Returns the live rate with source and target currency codes. Wise rates are typically very close to the real mid-market rate. Use for currency conversion questions like \"what is the EUR to USD rate?\", \"how much is 1000 GBP in EUR?\", or comparing rates before making transfers.", "operationId": "get_wise_exchange_rate", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "source", "target" ], "properties": { "source": { "type": "string", "description": "Source currency code (e.g., EUR, USD, GBP)" }, "target": { "type": "string", "description": "Target currency code (e.g., USD, EUR, GBP)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_chargebee_subscriptions": { "post": { "summary": "Retrieve subscription records from Chargebee subscription billing platform. Returns subscription ID, plan, status (active, cancelled, non_renewing, future), customer info, billing period, and pricing. Filter by status to focus on active or churned subscriptions. Use for SaaS metrics, churn analysis, or answering \"how many active subscriptions?\", \"show cancelled subscriptions\", or \"what plans are customers on?\"", "description": "Retrieve subscription records from Chargebee subscription billing platform. Returns subscription ID, plan, status (active, cancelled, non_renewing, future), customer info, billing period, and pricing. Filter by status to focus on active or churned subscriptions. Use for SaaS metrics, churn analysis, or answering \"how many active subscriptions?\", \"show cancelled subscriptions\", or \"what plans are customers on?\"", "operationId": "get_chargebee_subscriptions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of subscriptions to return" }, "status": { "type": "string", "enum": [ "active", "cancelled", "non_renewing", "future" ], "description": "Filter by subscription status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_chargebee_customers": { "post": { "summary": "Retrieve customer records from Chargebee billing. Returns customer ID, name, email, company, billing address, and subscription count. Use for customer lookups, billing inquiries, or answering \"who are our Chargebee customers?\" or \"find customer billing details.\"", "description": "Retrieve customer records from Chargebee billing. Returns customer ID, name, email, company, billing address, and subscription count. Use for customer lookups, billing inquiries, or answering \"who are our Chargebee customers?\" or \"find customer billing details.\"", "operationId": "get_chargebee_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of customers to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_chargebee_invoices": { "post": { "summary": "Retrieve invoices from Chargebee subscription billing. Returns invoice number, amount, currency, status (paid, posted, payment_due, not_paid, voided, pending), customer, line items, and dates. Filter by status to find outstanding or paid invoices. Use for billing review or answering \"show unpaid invoices\", \"what invoices are overdue?\", or \"how much have we billed?\"", "description": "Retrieve invoices from Chargebee subscription billing. Returns invoice number, amount, currency, status (paid, posted, payment_due, not_paid, voided, pending), customer, line items, and dates. Filter by status to find outstanding or paid invoices. Use for billing review or answering \"show unpaid invoices\", \"what invoices are overdue?\", or \"how much have we billed?\"", "operationId": "get_chargebee_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of invoices to return" }, "status": { "type": "string", "enum": [ "paid", "posted", "payment_due", "not_paid", "voided", "pending" ], "description": "Filter by invoice status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_chargebee_plans": { "post": { "summary": "Retrieve subscription plans and item prices from Chargebee. Returns plan name, ID, pricing (amount, currency, billing period), trial settings, and status. Use for pricing catalog review or answering \"what subscription plans do we offer?\", \"how much is the premium plan?\", or \"list all pricing tiers.\"", "description": "Retrieve subscription plans and item prices from Chargebee. Returns plan name, ID, pricing (amount, currency, billing period), trial settings, and status. Use for pricing catalog review or answering \"what subscription plans do we offer?\", \"how much is the premium plan?\", or \"list all pricing tiers.\"", "operationId": "get_chargebee_plans", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of plans to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gocardless_payments": { "post": { "summary": "Retrieve direct debit payment records from GoCardless. Returns payment amount, currency, status (pending_submission, submitted, confirmed, paid_out, cancelled, failed), charge date, and linked mandate. Filter by status to track payment lifecycle. Use for payment reconciliation or answering \"what GoCardless payments are pending?\", \"show failed payments\", or \"how much have we collected via direct debit?\"", "description": "Retrieve direct debit payment records from GoCardless. Returns payment amount, currency, status (pending_submission, submitted, confirmed, paid_out, cancelled, failed), charge date, and linked mandate. Filter by status to track payment lifecycle. Use for payment reconciliation or answering \"what GoCardless payments are pending?\", \"show failed payments\", or \"how much have we collected via direct debit?\"", "operationId": "get_gocardless_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of payments to return" }, "status": { "type": "string", "enum": [ "pending_submission", "submitted", "confirmed", "paid_out", "cancelled", "failed" ], "description": "Filter by payment status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gocardless_mandates": { "post": { "summary": "Retrieve direct debit mandate authorizations from GoCardless. Returns mandate ID, status (pending_submission, submitted, active, failed, cancelled, expired), scheme (BACS, SEPA, etc.), customer reference, and creation date. Mandates authorize recurring payments from customer bank accounts. Use for checking payment authorization status or answering \"how many active mandates?\", \"which mandates expired?\", or \"show direct debit agreements.\"", "description": "Retrieve direct debit mandate authorizations from GoCardless. Returns mandate ID, status (pending_submission, submitted, active, failed, cancelled, expired), scheme (BACS, SEPA, etc.), customer reference, and creation date. Mandates authorize recurring payments from customer bank accounts. Use for checking payment authorization status or answering \"how many active mandates?\", \"which mandates expired?\", or \"show direct debit agreements.\"", "operationId": "get_gocardless_mandates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of mandates to return" }, "status": { "type": "string", "enum": [ "pending_submission", "submitted", "active", "failed", "cancelled", "expired" ], "description": "Filter by mandate status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gocardless_customers": { "post": { "summary": "Retrieve customer records from GoCardless direct debit platform. Returns customer name, email, address, and linked mandate\/payment counts. Use for customer lookups or answering \"who are our GoCardless customers?\" or \"find customer direct debit details.\"", "description": "Retrieve customer records from GoCardless direct debit platform. Returns customer name, email, address, and linked mandate\/payment counts. Use for customer lookups or answering \"who are our GoCardless customers?\" or \"find customer direct debit details.\"", "operationId": "get_gocardless_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of customers to return" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gocardless_payouts": { "post": { "summary": "Retrieve payout records from GoCardless \u2014 the actual bank transfers of collected funds to your account. Returns payout amount, currency, status (pending, paid, bounced), arrival date, and linked payments. Use for cash flow tracking or answering \"when will GoCardless funds arrive?\", \"show recent payouts\", or \"how much has been paid out?\"", "description": "Retrieve payout records from GoCardless \u2014 the actual bank transfers of collected funds to your account. Returns payout amount, currency, status (pending, paid, bounced), arrival date, and linked payments. Use for cash flow tracking or answering \"when will GoCardless funds arrive?\", \"show recent payouts\", or \"how much has been paid out?\"", "operationId": "get_gocardless_payouts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20, "description": "Number of payouts to return" }, "status": { "type": "string", "enum": [ "pending", "paid", "bounced" ], "description": "Filter by payout status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pipedrive_deals": { "post": { "summary": "Get sales deals from Pipedrive CRM pipeline. Returns deal title, value, currency, stage, status, contact person, organization, expected close date, and pipeline. Filter by status (all\/open\/won\/lost). Use for sales reporting, pipeline review, or answering \"what deals do we have?\" or \"show me open deals.\"", "description": "Get sales deals from Pipedrive CRM pipeline. Returns deal title, value, currency, stage, status, contact person, organization, expected close date, and pipeline. Filter by status (all\/open\/won\/lost). Use for sales reporting, pipeline review, or answering \"what deals do we have?\" or \"show me open deals.\"", "operationId": "get_pipedrive_deals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "all", "open", "won", "lost" ], "default": "all" }, "limit": { "type": "integer", "default": 20 }, "sort": { "type": "string", "description": "Pipedrive sort order, format \"field DIRECTION\". Examples: \"add_time DESC\" (newest first), \"update_time DESC\" (recently updated, default), \"value DESC\" (biggest deals first).", "default": "update_time DESC" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pipedrive_contacts": { "post": { "summary": "Get contact persons from Pipedrive CRM. Returns name, email, phone, organization, and associated deals. Use for finding client contact info or answering \"who is our contact at company X?\" or \"list our CRM contacts.\"", "description": "Get contact persons from Pipedrive CRM. Returns name, email, phone, organization, and associated deals. Use for finding client contact info or answering \"who is our contact at company X?\" or \"list our CRM contacts.\"", "operationId": "get_pipedrive_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pipedrive_organizations": { "post": { "summary": "Get company\/organization records from Pipedrive CRM. Returns company name, address, industry, deal count, and contact persons. Use for company lookups or answering \"what companies are in our CRM?\" or \"show me organization details.\"", "description": "Get company\/organization records from Pipedrive CRM. Returns company name, address, industry, deal count, and contact persons. Use for company lookups or answering \"what companies are in our CRM?\" or \"show me organization details.\"", "operationId": "get_pipedrive_organizations", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pipedrive_activities": { "post": { "summary": "Get scheduled and completed activities from Pipedrive CRM: calls, meetings, tasks, deadlines, and emails. Returns activity type, subject, due date, duration, and associated deal\/contact. Use for activity tracking or answering \"what meetings are coming up?\" or \"what tasks are pending?\"", "description": "Get scheduled and completed activities from Pipedrive CRM: calls, meetings, tasks, deadlines, and emails. Returns activity type, subject, due date, duration, and associated deal\/contact. Use for activity tracking or answering \"what meetings are coming up?\" or \"what tasks are pending?\"", "operationId": "get_pipedrive_activities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_pipedrive_deals": { "post": { "summary": "Search Pipedrive deals by keyword across deal titles, notes, and custom fields. Returns matching deals with value, status, and pipeline stage. Use when looking for a specific deal by name, client, or description.", "description": "Search Pipedrive deals by keyword across deal titles, notes, and custom fields. Returns matching deals with value, status, and pipeline stage. Use when looking for a specific deal by name, client, or description.", "operationId": "search_pipedrive_deals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search term" } }, "required": [ "query" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_invoices": { "post": { "summary": "Get sales invoices from Merit Aktiva accounting software. Returns invoice number, client name, date, due date, total amount, currency, and payment status. Filter unpaid_only=true to see outstanding invoices. Use for financial reporting or answering \"what invoices are unpaid?\" or \"show me recent invoices.\"", "description": "Get sales invoices from Merit Aktiva accounting software. Returns invoice number, client name, date, due date, total amount, currency, and payment status. Filter unpaid_only=true to see outstanding invoices. Use for financial reporting or answering \"what invoices are unpaid?\" or \"show me recent invoices.\"", "operationId": "get_merit_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "unpaid_only": { "type": "boolean", "default": false } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_purchases": { "post": { "summary": "Get purchase invoices from Merit Aktiva accounting software. Returns supplier, invoice number, document date, due date, total amount, currency, and payment details. Use for expense tracking or answering \"show purchase invoices\" or \"what supplier bills do we have?\"", "description": "Get purchase invoices from Merit Aktiva accounting software. Returns supplier, invoice number, document date, due date, total amount, currency, and payment details. Use for expense tracking or answering \"show purchase invoices\" or \"what supplier bills do we have?\"", "operationId": "get_merit_purchases", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_taxes": { "post": { "summary": "Get active VAT tax rates and their Merit tax IDs. Use before creating an invoice so every line and VAT summary carries a valid TaxId.", "description": "Get active VAT tax rates and their Merit tax IDs. Use before creating an invoice so every line and VAT summary carries a valid TaxId.", "operationId": "get_merit_taxes", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_merit_sales_invoice": { "post": { "summary": "Create one sales invoice in Merit Aktiva. This is an external write and must only be called after the human explicitly submits or confirms the invoice.", "description": "Create one sales invoice in Merit Aktiva. This is an external write and must only be called after the human explicitly submits or confirms the invoice.", "operationId": "create_merit_sales_invoice", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "invoice" ], "properties": { "invoice": { "type": "object", "additionalProperties": false, "required": [ "Customer", "InvoiceNo", "DocDate", "DueDate", "TransactionDate", "CurrencyCode", "CurrencyRate", "InvoiceRow", "TotalAmount", "TaxAmount" ], "properties": { "Customer": { "type": "object", "additionalProperties": false, "required": [ "Name" ], "properties": { "Id": { "type": "string", "format": "uuid" }, "Name": { "type": "string", "minLength": 1, "maxLength": 150 }, "RegNo": { "type": "string", "maxLength": 50 }, "VatRegNo": { "type": "string", "maxLength": 50 }, "NotTDCustomer": { "type": "boolean" }, "CountryCode": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "InvoiceNo": { "type": "string", "minLength": 1, "maxLength": 50 }, "DocDate": { "type": "string", "pattern": "^\\d{8}$" }, "DueDate": { "type": "string", "pattern": "^\\d{8}$" }, "TransactionDate": { "type": "string", "pattern": "^\\d{8}$" }, "CurrencyCode": { "type": "string", "pattern": "^[A-Z]{3}$" }, "CurrencyRate": { "type": "number", "minimum": 1.0e-6 }, "InvoiceRow": { "type": "array", "minItems": 1, "maxItems": 500, "items": { "type": "object", "additionalProperties": false, "required": [ "Item", "Quantity", "Price", "TaxId" ], "properties": { "Item": { "type": "object", "additionalProperties": false, "required": [ "Code", "Description", "Type", "UOMName" ], "properties": { "Code": { "type": "string", "minLength": 1, "maxLength": 50 }, "Description": { "type": "string", "minLength": 1, "maxLength": 150 }, "Type": { "type": "integer", "enum": [ 1, 2, 3 ] }, "UOMName": { "type": "string", "minLength": 1, "maxLength": 30 } } }, "Quantity": { "type": "number", "minimum": 1.0e-6 }, "Price": { "type": "number", "minimum": 0 }, "TaxId": { "type": "string", "format": "uuid" } } } }, "TotalAmount": { "type": "number", "minimum": 0 }, "TaxAmount": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "TaxId", "Amount" ], "properties": { "TaxId": { "type": "string", "format": "uuid" }, "Amount": { "type": "number", "minimum": 0 } } } }, "HComment": { "type": "string", "maxLength": 2000 } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_merit_customer": { "post": { "summary": "Create or update one customer in Merit Aktiva (Merit matches on registry code \/ name). Returns the Merit customer id. This is an external write and must only be called after the human explicitly confirms it.", "description": "Create or update one customer in Merit Aktiva (Merit matches on registry code \/ name). Returns the Merit customer id. This is an external write and must only be called after the human explicitly confirms it.", "operationId": "create_merit_customer", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "customer" ], "properties": { "customer": { "type": "object", "description": "Merit Customer object. Name is required. Pass Id (the Merit customer GUID) to UPDATE an existing card; without Id Merit creates a new one and answers \"api-custexists\" if the name is taken.", "required": [ "Name" ], "properties": { "Id": { "type": "string", "description": "Merit customer GUID \u2014 present means update, absent means create." }, "Name": { "type": "string" }, "Contact": { "type": "string" }, "PhoneNo2": { "type": "string" }, "BankName": { "type": "string" }, "SalesInvLang": { "type": "string", "description": "ET, EN, FI or RU" }, "NotTDCustomer": { "type": "boolean" }, "OverdueCharge": { "type": "number", "description": "NB Merit spells it OverdueCharge, not OverDueCharge." }, "RegNo": { "type": "string" }, "VatRegNo": { "type": "string" }, "Address": { "type": "string" }, "City": { "type": "string" }, "County": { "type": "string" }, "PostalCode": { "type": "string" }, "CountryCode": { "type": "string" }, "PhoneNo": { "type": "string" }, "Email": { "type": "string" }, "HomePage": { "type": "string" }, "BankAccount": { "type": "string" }, "CurrencyCode": { "type": "string" }, "PaymentDeadLine": { "type": "integer" }, "RefNoBase": { "type": "string" }, "Notes": { "type": "string" } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_general_ledger": { "post": { "summary": "Get Merit Aktiva GENERAL LEDGER batches with their entry lines for a period (max 31 days) \u2014 the real bookkeeping: depreciation, payroll, interest, accountant corrections, not just invoices. Use to mirror Merit's books or reconcile a period.", "description": "Get Merit Aktiva GENERAL LEDGER batches with their entry lines for a period (max 31 days) \u2014 the real bookkeeping: depreciation, payroll, interest, accountant corrections, not just invoices. Use to mirror Merit's books or reconcile a period.", "operationId": "get_merit_general_ledger", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "period_start", "period_end" ], "properties": { "period_start": { "type": "string", "description": "yyyymmdd" }, "period_end": { "type": "string", "description": "yyyymmdd, max 31 days from start" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_merit_invoice_as_einvoice": { "post": { "summary": "Send an EXISTING Merit sales invoice to the customer as a real e-invoice through Merit's e-invoice operator (machine-to-machine into the buyer's accounting software). Takes the invoice SIHId. Returns sent=false with status \"no_einvoice_recipient\" when the buyer is not registered as an e-invoice receiver. This is an external write and must only be called after the human explicitly confirms sending.", "description": "Send an EXISTING Merit sales invoice to the customer as a real e-invoice through Merit's e-invoice operator (machine-to-machine into the buyer's accounting software). Takes the invoice SIHId. Returns sent=false with status \"no_einvoice_recipient\" when the buyer is not registered as an e-invoice receiver. This is an external write and must only be called after the human explicitly confirms sending.", "operationId": "send_merit_invoice_as_einvoice", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "invoice_id" ], "properties": { "invoice_id": { "type": "string", "description": "Merit sales invoice SIHId (GUID)" }, "delivery_note": { "type": "boolean", "description": "Send without prices (delivery note). Default false." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_merit_purchase_invoice": { "post": { "summary": "Create one purchase invoice in Merit Aktiva. This is an external write and must only be called after the human explicitly submits or confirms the invoice.", "description": "Create one purchase invoice in Merit Aktiva. This is an external write and must only be called after the human explicitly submits or confirms the invoice.", "operationId": "create_merit_purchase_invoice", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "invoice" ], "properties": { "invoice": { "type": "object", "additionalProperties": false, "required": [ "Vendor", "BillNo", "DocDate", "DueDate", "TransactionDate", "CurrencyCode", "CurrencyRate", "InvoiceRow", "TotalAmount", "TaxAmount" ], "properties": { "Vendor": { "type": "object", "additionalProperties": false, "required": [ "Name" ], "properties": { "Id": { "type": "string", "format": "uuid" }, "Name": { "type": "string", "minLength": 1, "maxLength": 150 }, "RegNo": { "type": "string", "maxLength": 50 }, "VatRegNo": { "type": "string", "maxLength": 50 }, "NotTDCustomer": { "type": "boolean" }, "CountryCode": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "BillNo": { "type": "string", "minLength": 1, "maxLength": 50 }, "DocDate": { "type": "string", "pattern": "^\\d{8}$" }, "DueDate": { "type": "string", "pattern": "^\\d{8}$" }, "TransactionDate": { "type": "string", "pattern": "^\\d{8}$" }, "CurrencyCode": { "type": "string", "pattern": "^[A-Z]{3}$" }, "CurrencyRate": { "type": "number", "minimum": 1.0e-6 }, "InvoiceRow": { "type": "array", "minItems": 1, "maxItems": 500, "items": { "type": "object", "additionalProperties": false, "required": [ "Item", "Quantity", "Price", "TaxId" ], "properties": { "Item": { "type": "object", "additionalProperties": false, "required": [ "Code", "Description", "Type", "UOMName" ], "properties": { "Code": { "type": "string", "minLength": 1, "maxLength": 50 }, "Description": { "type": "string", "minLength": 1, "maxLength": 150 }, "Type": { "type": "integer", "enum": [ 1, 2, 3 ] }, "UOMName": { "type": "string", "minLength": 1, "maxLength": 30 } } }, "Quantity": { "type": "number", "minimum": 1.0e-6 }, "Price": { "type": "number", "minimum": 0 }, "TaxId": { "type": "string", "format": "uuid" } } } }, "TotalAmount": { "type": "number", "minimum": 0 }, "TaxAmount": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "TaxId", "Amount" ], "properties": { "TaxId": { "type": "string", "format": "uuid" }, "Amount": { "type": "number", "minimum": 0 } } } }, "HComment": { "type": "string", "maxLength": 2000 } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_revenue_by_month": { "post": { "summary": "Get monthly revenue from Merit Aktiva for the current year. Returns an array of {month, month_name, revenue, invoice_count} rows \u2014 one per month. Use for revenue trend charts or answering \"what is our monthly revenue this year?\" or \"show revenue by month.\"", "description": "Get monthly revenue from Merit Aktiva for the current year. Returns an array of {month, month_name, revenue, invoice_count} rows \u2014 one per month. Use for revenue trend charts or answering \"what is our monthly revenue this year?\" or \"show revenue by month.\"", "operationId": "get_merit_revenue_by_month", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "year": { "type": "integer", "description": "Year to report (default: current year)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_customers": { "post": { "summary": "Get customer records from Merit Aktiva accounting. Returns customer name, registration code, VAT number, address, email, phone, and outstanding balance. Use for customer lookups or answering \"who are our clients in Merit?\" or \"find customer details.\"", "description": "Get customer records from Merit Aktiva accounting. Returns customer name, registration code, VAT number, address, email, phone, and outstanding balance. Use for customer lookups or answering \"who are our clients in Merit?\" or \"find customer details.\"", "operationId": "get_merit_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_payments": { "post": { "summary": "Get payment records from Merit Aktiva accounting. Returns payment date, amount, currency, payer, invoice reference, and payment method. Use for cash flow tracking or answering \"what payments have we received?\" or \"show recent payments.\"", "description": "Get payment records from Merit Aktiva accounting. Returns payment date, amount, currency, payer, invoice reference, and payment method. Use for cash flow tracking or answering \"what payments have we received?\" or \"show recent payments.\"", "operationId": "get_merit_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_customer_debts": { "post": { "summary": "Get the customer debts (aging) report from Merit Aktiva: every open sales invoice with total, paid and unpaid amounts plus due date. Use for answering \"who owes us money?\", overdue invoice follow-ups, or accounts receivable aging.", "description": "Get the customer debts (aging) report from Merit Aktiva: every open sales invoice with total, paid and unpaid amounts plus due date. Use for answering \"who owes us money?\", overdue invoice follow-ups, or accounts receivable aging.", "operationId": "get_merit_customer_debts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "overdue_days": { "type": "integer", "default": 0, "description": "Only invoices overdue at least this many days" }, "debt_date": { "type": "string", "description": "Balance date yyyyMMdd (default: today)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_income_statement": { "post": { "summary": "Get the official income statement (kasumiaruanne \/ profit & loss) report from Merit Aktiva with monthly period columns. Use for revenue\/expense\/profit questions that must match official accounting.", "description": "Get the official income statement (kasumiaruanne \/ profit & loss) report from Merit Aktiva with monthly period columns. Use for revenue\/expense\/profit questions that must match official accounting.", "operationId": "get_merit_income_statement", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "end_date": { "type": "string", "description": "Period end yyyymmdd (default: end of current month)" }, "per_count": { "type": "integer", "default": 6, "description": "Number of monthly periods (1-12)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_balance_sheet": { "post": { "summary": "Get the official balance sheet (bilanss \/ statement of financial position) from Merit Aktiva. Use for assets\/liabilities\/equity questions that must match official accounting.", "description": "Get the official balance sheet (bilanss \/ statement of financial position) from Merit Aktiva. Use for assets\/liabilities\/equity questions that must match official accounting.", "operationId": "get_merit_balance_sheet", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "end_date": { "type": "string", "description": "Balance date yyyymmdd (default: today)" }, "per_count": { "type": "integer", "default": 2, "description": "Number of monthly periods (1-12)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_accounts": { "post": { "summary": "Get the chart of accounts (kontoplaan) from Merit Aktiva: account code, name and type. Use for ledger setup, account mapping or bookkeeping questions.", "description": "Get the chart of accounts (kontoplaan) from Merit Aktiva: account code, name and type. Use for ledger setup, account mapping or bookkeeping questions.", "operationId": "get_merit_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_payments_period": { "post": { "summary": "Get payment records from Merit Aktiva for an explicit date range (get_merit_payments is fixed to the last 3 months). Use for historical payment\/cash-flow backfills.", "description": "Get payment records from Merit Aktiva for an explicit date range (get_merit_payments is fixed to the last 3 months). Use for historical payment\/cash-flow backfills.", "operationId": "get_merit_payments_period", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "period_start": { "type": "string", "description": "yyyymmdd" }, "period_end": { "type": "string", "description": "yyyymmdd" } }, "required": [ "period_start", "period_end" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_invoices_period": { "post": { "summary": "Get sales invoices from Merit Aktiva for an explicit date range (get_merit_invoices is fixed to the last 3 months). Merit caps one query at ~3 months, so chunk longer ranges. Use for historical invoice backfills.", "description": "Get sales invoices from Merit Aktiva for an explicit date range (get_merit_invoices is fixed to the last 3 months). Merit caps one query at ~3 months, so chunk longer ranges. Use for historical invoice backfills.", "operationId": "get_merit_invoices_period", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "period_start": { "type": "string", "description": "yyyymmdd" }, "period_end": { "type": "string", "description": "yyyymmdd" } }, "required": [ "period_start", "period_end" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_purchases_period": { "post": { "summary": "Get purchase (supplier) invoices from Merit Aktiva for an explicit date range (get_merit_purchases is fixed to the last 3 months). Merit caps one query at ~3 months, so chunk longer ranges. Use for historical expense backfills.", "description": "Get purchase (supplier) invoices from Merit Aktiva for an explicit date range (get_merit_purchases is fixed to the last 3 months). Merit caps one query at ~3 months, so chunk longer ranges. Use for historical expense backfills.", "operationId": "get_merit_purchases_period", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "period_start": { "type": "string", "description": "yyyymmdd" }, "period_end": { "type": "string", "description": "yyyymmdd" } }, "required": [ "period_start", "period_end" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_invoice_detail": { "post": { "summary": "Get one Merit Aktiva sales invoice in full: header, line items (description, quantity, price, VAT, account), payments and attachment flag. The list tools return headers only \u2014 use this when you need what was actually invoiced.", "description": "Get one Merit Aktiva sales invoice in full: header, line items (description, quantity, price, VAT, account), payments and attachment flag. The list tools return headers only \u2014 use this when you need what was actually invoiced.", "operationId": "get_merit_invoice_detail", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "Merit sales invoice id (SIHId)" } }, "required": [ "id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_purchase_detail": { "post": { "summary": "Get one Merit Aktiva purchase (supplier) invoice in full: header, line items, payments and attachment flag. Use when you need the expense rows behind a purchase invoice.", "description": "Get one Merit Aktiva purchase (supplier) invoice in full: header, line items, payments and attachment flag. Use when you need the expense rows behind a purchase invoice.", "operationId": "get_merit_purchase_detail", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "Merit purchase invoice id (PIHId)" } }, "required": [ "id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_merit_products": { "post": { "summary": "Get product\/service catalog from Merit Aktiva accounting. Returns item name, code, unit price, VAT rate, and unit of measure. Use for product lookups, pricing questions, or answering \"what products do we sell?\" or \"what is the price of product X?\"", "description": "Get product\/service catalog from Merit Aktiva accounting. Returns item name, code, unit price, VAT rate, and unit of measure. Use for product lookups, pricing questions, or answering \"what products do we sell?\" or \"what is the price of product X?\"", "operationId": "get_merit_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pandadoc_documents": { "post": { "summary": "List documents from PandaDoc. Filter by status (document.draft, document.sent, document.completed, document.viewed, document.declined) or search by name.", "description": "List documents from PandaDoc. Filter by status (document.draft, document.sent, document.completed, document.viewed, document.declined) or search by name.", "operationId": "get_pandadoc_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "description": "Filter by status: document.draft, document.sent, document.completed, document.viewed, document.declined" }, "query": { "type": "string", "description": "Search documents by name" }, "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pandadoc_document": { "post": { "summary": "Get full details of a specific PandaDoc document including recipients, fields, pricing, and signing status.", "description": "Get full details of a specific PandaDoc document including recipients, fields, pricing, and signing status.", "operationId": "get_pandadoc_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "document_id": { "type": "string", "description": "PandaDoc document ID" } }, "required": [ "document_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_pandadoc_document": { "post": { "summary": "Create a new PandaDoc document from a template. Add recipients, fill tokens\/fields, and set pricing items.", "description": "Create a new PandaDoc document from a template. Add recipients, fill tokens\/fields, and set pricing items.", "operationId": "create_pandadoc_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Document name (e.g. \"Proposal for Acme Corp\")" }, "template_id": { "type": "string", "description": "Template UUID. Use get_pandadoc_templates to find available templates." }, "recipients": { "type": "array", "description": "List of recipients", "items": { "type": "object", "properties": { "email": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "role": { "type": "string", "default": "signer", "description": "Role: signer, CC, approver" } }, "required": [ "email" ] } }, "tokens": { "type": "array", "description": "Template tokens\/variables to fill (e.g. [{\"name\": \"Client.Name\", \"value\": \"Acme\"}])", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "pricing_items": { "type": "array", "description": "Pricing table items", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "Item name" }, "description": { "type": "string" }, "price": { "type": "number", "description": "Unit price" }, "qty": { "type": "integer", "default": 1 } }, "required": [ "name", "price" ] } } }, "required": [ "name", "template_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_pandadoc_document": { "post": { "summary": "Send a PandaDoc document for e-signing. Document must be in draft status. Optionally set a custom email subject and message, or use silent mode to move to sent status without emailing. Use when asked to \"send this proposal for signing\", \"get signatures on the document\", or \"send the contract to the client.\"", "description": "Send a PandaDoc document for e-signing. Document must be in draft status. Optionally set a custom email subject and message, or use silent mode to move to sent status without emailing. Use when asked to \"send this proposal for signing\", \"get signatures on the document\", or \"send the contract to the client.\"", "operationId": "send_pandadoc_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "document_id": { "type": "string", "description": "PandaDoc document ID" }, "subject": { "type": "string", "description": "Email subject line" }, "message": { "type": "string", "description": "Email message body" }, "silent": { "type": "boolean", "default": false, "description": "If true, no email is sent (document is just moved to sent status)" } }, "required": [ "document_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pandadoc_templates": { "post": { "summary": "List available PandaDoc document templates. Returns template name, ID, creation date, and folder. Search by name to find specific templates. Template IDs are needed to create new documents. Use when asked \"what PandaDoc templates do we have?\", \"find a proposal template\", or before creating a document from a template.", "description": "List available PandaDoc document templates. Returns template name, ID, creation date, and folder. Search by name to find specific templates. Template IDs are needed to create new documents. Use when asked \"what PandaDoc templates do we have?\", \"find a proposal template\", or before creating a document from a template.", "operationId": "get_pandadoc_templates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search templates by name" }, "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_simplbooks_invoices": { "post": { "summary": "Get sales invoices from SimplBooks Estonian accounting software. Returns invoice number, client, date, due date, total amount, and payment status. Filter unpaid_only=true for outstanding invoices. Use for financial overview or answering \"show SimplBooks invoices\", \"what invoices are unpaid?\", or \"how much have we billed?\"", "description": "Get sales invoices from SimplBooks Estonian accounting software. Returns invoice number, client, date, due date, total amount, and payment status. Filter unpaid_only=true for outstanding invoices. Use for financial overview or answering \"show SimplBooks invoices\", \"what invoices are unpaid?\", or \"how much have we billed?\"", "operationId": "get_simplbooks_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "unpaid_only": { "type": "boolean", "default": false } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_simplbooks_clients": { "post": { "summary": "Get client\/customer records from SimplBooks accounting. Returns client name, registration code, contact info, and outstanding balance. Use for client lookups or answering \"who are our clients in SimplBooks?\" or \"find customer details.\"", "description": "Get client\/customer records from SimplBooks accounting. Returns client name, registration code, contact info, and outstanding balance. Use for client lookups or answering \"who are our clients in SimplBooks?\" or \"find customer details.\"", "operationId": "get_simplbooks_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_simplbooks_articles": { "post": { "summary": "Get articles (products\/services) from SimplBooks accounting catalog. Returns article name, code, unit price, VAT rate, and unit. Use for product lookups or answering \"what products are in SimplBooks?\" or \"check article prices.\"", "description": "Get articles (products\/services) from SimplBooks accounting catalog. Returns article name, code, unit price, VAT rate, and unit. Use for product lookups or answering \"what products are in SimplBooks?\" or \"check article prices.\"", "operationId": "get_simplbooks_articles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_simplbooks_payments": { "post": { "summary": "Get payment records from SimplBooks accounting. Returns payment date, amount, payer, and invoice reference. Use for payment tracking or answering \"what payments have we received?\" or \"show recent SimplBooks payments.\"", "description": "Get payment records from SimplBooks accounting. Returns payment date, amount, payer, and invoice reference. Use for payment tracking or answering \"what payments have we received?\" or \"show recent SimplBooks payments.\"", "operationId": "get_simplbooks_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_simplbooks_purchases": { "post": { "summary": "Get purchase invoices (bills from suppliers) from SimplBooks accounting. Returns supplier name, invoice number, amount, date, and payment status. Use for expense tracking or answering \"show our purchase invoices\" or \"what do we owe suppliers?\"", "description": "Get purchase invoices (bills from suppliers) from SimplBooks accounting. Returns supplier name, invoice number, amount, date, and payment status. Use for expense tracking or answering \"show our purchase invoices\" or \"what do we owe suppliers?\"", "operationId": "get_simplbooks_purchases", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_procountor_invoices": { "post": { "summary": "Get invoices from Procountor Finnish financial management software. Returns invoice number, customer, amount, currency, status, and dates. Filter by status. Use for billing review or answering \"show Procountor invoices\" or \"what invoices are outstanding?\"", "description": "Get invoices from Procountor Finnish financial management software. Returns invoice number, customer, amount, currency, status, and dates. Filter by status. Use for billing review or answering \"show Procountor invoices\" or \"what invoices are outstanding?\"", "operationId": "get_procountor_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "status": { "type": "string", "description": "Filter by status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_procountor_partners": { "post": { "summary": "Get business partners (customers or suppliers) from Procountor. Returns partner name, business ID, type (CUSTOMER\/SUPPLIER), contact info, and address. Filter by type. Use for partner lookups or answering \"who are our Procountor customers?\" or \"list suppliers.\"", "description": "Get business partners (customers or suppliers) from Procountor. Returns partner name, business ID, type (CUSTOMER\/SUPPLIER), contact info, and address. Filter by type. Use for partner lookups or answering \"who are our Procountor customers?\" or \"list suppliers.\"", "operationId": "get_procountor_partners", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "type": { "type": "string", "enum": [ "CUSTOMER", "SUPPLIER" ], "default": "CUSTOMER" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_procountor_products": { "post": { "summary": "Get products\/services from Procountor financial management. Returns product name, code, unit price, and VAT info. Use for catalog review or answering \"what products are in Procountor?\" or \"check product pricing.\"", "description": "Get products\/services from Procountor financial management. Returns product name, code, unit price, and VAT info. Use for catalog review or answering \"what products are in Procountor?\" or \"check product pricing.\"", "operationId": "get_procountor_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_procountor_ledger": { "post": { "summary": "Get ledger receipts and journal entries from Procountor. Returns entry date, account, description, debit\/credit amounts, and document reference. Use for bookkeeping review or answering \"show ledger entries\" or \"check journal transactions.\"", "description": "Get ledger receipts and journal entries from Procountor. Returns entry date, account, description, debit\/credit amounts, and document reference. Use for bookkeeping review or answering \"show ledger entries\" or \"check journal transactions.\"", "operationId": "get_procountor_ledger", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lemonsoft_invoices": { "post": { "summary": "Get invoices from Lemonsoft Finnish ERP system. Returns invoice number, customer, amount, date, and payment status. Filter unpaid_only for outstanding invoices. Use for billing review or answering \"show Lemonsoft invoices\" or \"what is unpaid?\"", "description": "Get invoices from Lemonsoft Finnish ERP system. Returns invoice number, customer, amount, date, and payment status. Filter unpaid_only for outstanding invoices. Use for billing review or answering \"show Lemonsoft invoices\" or \"what is unpaid?\"", "operationId": "get_lemonsoft_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "unpaid_only": { "type": "boolean", "default": false } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lemonsoft_customers": { "post": { "summary": "Get customer records from Lemonsoft ERP. Returns customer name, number, contact info, and address. Use for customer lookups or answering \"who are our Lemonsoft customers?\" or \"find customer details.\"", "description": "Get customer records from Lemonsoft ERP. Returns customer name, number, contact info, and address. Use for customer lookups or answering \"who are our Lemonsoft customers?\" or \"find customer details.\"", "operationId": "get_lemonsoft_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lemonsoft_products": { "post": { "summary": "Get products from Lemonsoft ERP inventory. Returns product name, code, price, stock level, and unit. Use for inventory checks or answering \"what products do we have in Lemonsoft?\" or \"check stock levels.\"", "description": "Get products from Lemonsoft ERP inventory. Returns product name, code, price, stock level, and unit. Use for inventory checks or answering \"what products do we have in Lemonsoft?\" or \"check stock levels.\"", "operationId": "get_lemonsoft_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lemonsoft_orders": { "post": { "summary": "Get sales orders from Lemonsoft ERP. Returns order number, customer, items, total amount, and status. Use for order tracking or answering \"show Lemonsoft orders\" or \"what orders are pending?\"", "description": "Get sales orders from Lemonsoft ERP. Returns order number, customer, items, total amount, and status. Use for order tracking or answering \"show Lemonsoft orders\" or \"what orders are pending?\"", "operationId": "get_lemonsoft_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dynamics_invoices": { "post": { "summary": "Get sales invoices from Microsoft Dynamics 365 Business Central ERP. Returns invoice number, customer, amount, currency, posting date, and status. Use for financial review or answering \"show Dynamics invoices\" or \"what has been billed?\"", "description": "Get sales invoices from Microsoft Dynamics 365 Business Central ERP. Returns invoice number, customer, amount, currency, posting date, and status. Use for financial review or answering \"show Dynamics invoices\" or \"what has been billed?\"", "operationId": "get_dynamics_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dynamics_customers": { "post": { "summary": "Get customer records from Microsoft Dynamics 365 Business Central. Returns customer name, number, contact info, balance, and payment terms. Use for customer lookups or answering \"who are our customers in Dynamics?\" or \"check customer balance.\"", "description": "Get customer records from Microsoft Dynamics 365 Business Central. Returns customer name, number, contact info, balance, and payment terms. Use for customer lookups or answering \"who are our customers in Dynamics?\" or \"check customer balance.\"", "operationId": "get_dynamics_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dynamics_items": { "post": { "summary": "Get items\/products from Microsoft Dynamics 365 Business Central. Returns item name, number, unit price, inventory quantity, and category. Use for product catalog or answering \"what items are in Dynamics?\" or \"check inventory.\"", "description": "Get items\/products from Microsoft Dynamics 365 Business Central. Returns item name, number, unit price, inventory quantity, and category. Use for product catalog or answering \"what items are in Dynamics?\" or \"check inventory.\"", "operationId": "get_dynamics_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sap_invoices": { "post": { "summary": "Get sales invoices from SAP Business One ERP. Returns invoice number, customer, total amount, currency, posting date, and payment status. Use for financial review or answering \"show SAP invoices\" or \"what is billed in SAP?\"", "description": "Get sales invoices from SAP Business One ERP. Returns invoice number, customer, total amount, currency, posting date, and payment status. Use for financial review or answering \"show SAP invoices\" or \"what is billed in SAP?\"", "operationId": "get_sap_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sap_partners": { "post": { "summary": "Get business partners from SAP Business One. Returns partner name, code, type (Customer\/Supplier), contact info, balance, and payment terms. Filter by type. Use for partner lookups or answering \"who are our SAP customers?\" or \"list suppliers in SAP.\"", "description": "Get business partners from SAP Business One. Returns partner name, code, type (Customer\/Supplier), contact info, balance, and payment terms. Filter by type. Use for partner lookups or answering \"who are our SAP customers?\" or \"list suppliers in SAP.\"", "operationId": "get_sap_partners", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "type": { "type": "string", "enum": [ "cCustomer", "cSupplier" ], "default": "cCustomer" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sap_items": { "post": { "summary": "Get items\/products from SAP Business One inventory. Returns item name, code, price, warehouse stock, and group. Use for inventory management or answering \"what products are in SAP?\" or \"check item stock.\"", "description": "Get items\/products from SAP Business One inventory. Returns item name, code, price, warehouse stock, and group. Use for inventory management or answering \"what products are in SAP?\" or \"check item stock.\"", "operationId": "get_sap_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sap_orders": { "post": { "summary": "Get sales orders from SAP Business One. Returns order number, customer, items, total amount, delivery date, and status. Use for order tracking or answering \"show SAP sales orders\" or \"what orders are open?\"", "description": "Get sales orders from SAP Business One. Returns order number, customer, items, total amount, delivery date, and status. Use for order tracking or answering \"show SAP sales orders\" or \"what orders are open?\"", "operationId": "get_sap_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fortnox_invoices": { "post": { "summary": "Get invoices from Fortnox Swedish accounting software. Returns invoice number, customer, amount, currency, due date, and payment status. Use for billing review or answering \"show Fortnox invoices\" or \"what invoices are outstanding?\"", "description": "Get invoices from Fortnox Swedish accounting software. Returns invoice number, customer, amount, currency, due date, and payment status. Use for billing review or answering \"show Fortnox invoices\" or \"what invoices are outstanding?\"", "operationId": "get_fortnox_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fortnox_customers": { "post": { "summary": "Get customer records from Fortnox accounting. Returns customer name, number, org number, email, phone, and address. Use for customer lookups or answering \"who are our Fortnox customers?\"", "description": "Get customer records from Fortnox accounting. Returns customer name, number, org number, email, phone, and address. Use for customer lookups or answering \"who are our Fortnox customers?\"", "operationId": "get_fortnox_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fortnox_suppliers": { "post": { "summary": "Get supplier records from Fortnox accounting. Returns supplier name, number, org number, contact info, and payment terms. Use for supplier management or answering \"who are our suppliers in Fortnox?\" or \"list vendors.\"", "description": "Get supplier records from Fortnox accounting. Returns supplier name, number, org number, contact info, and payment terms. Use for supplier management or answering \"who are our suppliers in Fortnox?\" or \"list vendors.\"", "operationId": "get_fortnox_suppliers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fortnox_articles": { "post": { "summary": "Get articles\/products from Fortnox accounting. Returns article number, description, unit price, stock quantity, and unit. Use for product catalog or answering \"what articles are in Fortnox?\" or \"check product prices.\"", "description": "Get articles\/products from Fortnox accounting. Returns article number, description, unit price, stock quantity, and unit. Use for product catalog or answering \"what articles are in Fortnox?\" or \"check product prices.\"", "operationId": "get_fortnox_articles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_s4hana_invoices": { "post": { "summary": "Get billing documents from SAP S\/4HANA enterprise ERP. Returns document number, customer, amount, currency, billing date, and status. Use for enterprise billing review or answering \"show S\/4HANA invoices\" or \"what has been billed?\"", "description": "Get billing documents from SAP S\/4HANA enterprise ERP. Returns document number, customer, amount, currency, billing date, and status. Use for enterprise billing review or answering \"show S\/4HANA invoices\" or \"what has been billed?\"", "operationId": "get_s4hana_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_s4hana_customers": { "post": { "summary": "Get business partner (customer) records from SAP S\/4HANA. Returns partner name, number, industry, country, and contact details. Use for enterprise customer management or answering \"who are our S\/4HANA customers?\" or \"find business partner.\"", "description": "Get business partner (customer) records from SAP S\/4HANA. Returns partner name, number, industry, country, and contact details. Use for enterprise customer management or answering \"who are our S\/4HANA customers?\" or \"find business partner.\"", "operationId": "get_s4hana_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_s4hana_materials": { "post": { "summary": "Get material\/product master data from SAP S\/4HANA. Returns material number, description, type, unit, weight, and plant availability. Use for material management or answering \"what materials are in S\/4HANA?\" or \"check material master.\"", "description": "Get material\/product master data from SAP S\/4HANA. Returns material number, description, type, unit, weight, and plant availability. Use for material management or answering \"what materials are in S\/4HANA?\" or \"check material master.\"", "operationId": "get_s4hana_materials", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_s4hana_sales_orders": { "post": { "summary": "Get sales orders from SAP S\/4HANA. Returns order number, customer, items, net value, requested delivery date, and status. Use for order tracking or answering \"show S\/4HANA sales orders\" or \"what orders are pending?\"", "description": "Get sales orders from SAP S\/4HANA. Returns order number, customer, items, net value, requested delivery date, and status. Use for order tracking or answering \"show S\/4HANA sales orders\" or \"what orders are pending?\"", "operationId": "get_s4hana_sales_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_monitor_orders": { "post": { "summary": "Get sales\/production orders from Monitor ERP (Swedish manufacturing system). Returns order number, customer, items, amount, and status. Use for order tracking or answering \"show Monitor orders\" or \"what orders are in production?\"", "description": "Get sales\/production orders from Monitor ERP (Swedish manufacturing system). Returns order number, customer, items, amount, and status. Use for order tracking or answering \"show Monitor orders\" or \"what orders are in production?\"", "operationId": "get_monitor_orders", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_monitor_customers": { "post": { "summary": "Get customer records from Monitor ERP. Returns customer name, number, contact info, and address. Use for customer lookups or answering \"who are our Monitor ERP customers?\"", "description": "Get customer records from Monitor ERP. Returns customer name, number, contact info, and address. Use for customer lookups or answering \"who are our Monitor ERP customers?\"", "operationId": "get_monitor_customers", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_monitor_articles": { "post": { "summary": "Get articles\/products from Monitor ERP inventory. Returns article number, description, stock level, price, and unit. Use for inventory management or answering \"what articles are in Monitor?\" or \"check stock.\"", "description": "Get articles\/products from Monitor ERP inventory. Returns article number, description, stock level, price, and unit. Use for inventory management or answering \"what articles are in Monitor?\" or \"check stock.\"", "operationId": "get_monitor_articles", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_monitor_invoices": { "post": { "summary": "Get invoices from Monitor ERP. Returns invoice number, customer, amount, date, and payment status. Use for billing review or answering \"show Monitor invoices\" or \"what is outstanding?\"", "description": "Get invoices from Monitor ERP. Returns invoice number, customer, amount, date, and payment status. Use for billing review or answering \"show Monitor invoices\" or \"what is outstanding?\"", "operationId": "get_monitor_invoices", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_economic_invoices": { "post": { "summary": "Get booked invoices from e-conomic Danish online accounting. Returns invoice number, customer, amount, currency, date, and payment status. Use for financial review or answering \"show e-conomic invoices\" or \"what has been invoiced?\"", "description": "Get booked invoices from e-conomic Danish online accounting. Returns invoice number, customer, amount, currency, date, and payment status. Use for financial review or answering \"show e-conomic invoices\" or \"what has been invoiced?\"", "operationId": "get_economic_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_economic_customers": { "post": { "summary": "Get customer records from e-conomic accounting. Returns customer name, number, VAT number, email, and balance. Use for customer lookups or answering \"who are our e-conomic customers?\"", "description": "Get customer records from e-conomic accounting. Returns customer name, number, VAT number, email, and balance. Use for customer lookups or answering \"who are our e-conomic customers?\"", "operationId": "get_economic_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_economic_suppliers": { "post": { "summary": "Get supplier records from e-conomic accounting. Returns supplier name, number, contact info, and payment terms. Use for vendor management or answering \"who are our suppliers?\" or \"list e-conomic vendors.\"", "description": "Get supplier records from e-conomic accounting. Returns supplier name, number, contact info, and payment terms. Use for vendor management or answering \"who are our suppliers?\" or \"list e-conomic vendors.\"", "operationId": "get_economic_suppliers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_economic_products": { "post": { "summary": "Get products from e-conomic accounting catalog. Returns product name, number, unit price, cost price, and unit. Use for product review or answering \"what products are in e-conomic?\"", "description": "Get products from e-conomic accounting catalog. Returns product name, number, unit price, cost price, and unit. Use for product review or answering \"what products are in e-conomic?\"", "operationId": "get_economic_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_superoffice_contacts": { "post": { "summary": "Get company\/organization records from SuperOffice CRM. Returns company name, department, category, phone, email, and address. Use for company lookups or answering \"what companies are in SuperOffice?\" or \"find organization details.\"", "description": "Get company\/organization records from SuperOffice CRM. Returns company name, department, category, phone, email, and address. Use for company lookups or answering \"what companies are in SuperOffice?\" or \"find organization details.\"", "operationId": "get_superoffice_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_superoffice_persons": { "post": { "summary": "Get individual person\/contact records from SuperOffice CRM. Returns person name, title, email, phone, company association, and position. Use for contact lookups or answering \"who are our contacts in SuperOffice?\" or \"find person details.\"", "description": "Get individual person\/contact records from SuperOffice CRM. Returns person name, title, email, phone, company association, and position. Use for contact lookups or answering \"who are our contacts in SuperOffice?\" or \"find person details.\"", "operationId": "get_superoffice_persons", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_superoffice_sales": { "post": { "summary": "Get sales opportunities from SuperOffice CRM pipeline. Returns sale title, amount, stage, probability, expected close date, and owner. Use for sales pipeline review or answering \"what sales opportunities do we have?\" or \"show our SuperOffice pipeline.\"", "description": "Get sales opportunities from SuperOffice CRM pipeline. Returns sale title, amount, stage, probability, expected close date, and owner. Use for sales pipeline review or answering \"what sales opportunities do we have?\" or \"show our SuperOffice pipeline.\"", "operationId": "get_superoffice_sales", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_superoffice_projects": { "post": { "summary": "Get project records from SuperOffice CRM. Returns project name, type, status, manager, dates, and description. Use for project tracking or answering \"what projects are in SuperOffice?\" or \"show active projects.\"", "description": "Get project records from SuperOffice CRM. Returns project name, type, status, manager, dates, and description. Use for project tracking or answering \"what projects are in SuperOffice?\" or \"show active projects.\"", "operationId": "get_superoffice_projects", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tripletex_invoices": { "post": { "summary": "Get invoices from Tripletex Norwegian accounting software. Returns invoice number, customer, amount, currency, date, and payment status. Use for billing review or answering \"show Tripletex invoices.\"", "description": "Get invoices from Tripletex Norwegian accounting software. Returns invoice number, customer, amount, currency, date, and payment status. Use for billing review or answering \"show Tripletex invoices.\"", "operationId": "get_tripletex_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tripletex_customers": { "post": { "summary": "Get customer records from Tripletex accounting. Returns customer name, number, org number, email, and balance. Use for customer lookups or answering \"who are our Tripletex customers?\"", "description": "Get customer records from Tripletex accounting. Returns customer name, number, org number, email, and balance. Use for customer lookups or answering \"who are our Tripletex customers?\"", "operationId": "get_tripletex_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tripletex_products": { "post": { "summary": "Get products from Tripletex accounting catalog. Returns product name, number, unit price, cost, and unit. Use for product review or answering \"what products are in Tripletex?\"", "description": "Get products from Tripletex accounting catalog. Returns product name, number, unit price, cost, and unit. Use for product review or answering \"what products are in Tripletex?\"", "operationId": "get_tripletex_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_tripletex_accounts": { "post": { "summary": "Get ledger accounts from Tripletex chart of accounts. Returns account number, name, type, and balance. Use for bookkeeping or answering \"show our chart of accounts\" or \"list ledger accounts.\"", "description": "Get ledger accounts from Tripletex chart of accounts. Returns account number, name, type, and balance. Use for bookkeeping or answering \"show our chart of accounts\" or \"list ledger accounts.\"", "operationId": "get_tripletex_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_visma_invoices": { "post": { "summary": "Get customer invoices from Visma Net cloud ERP. Returns invoice number, customer, amount, currency, date, and status. Use for billing review or answering \"show Visma invoices.\"", "description": "Get customer invoices from Visma Net cloud ERP. Returns invoice number, customer, amount, currency, date, and status. Use for billing review or answering \"show Visma invoices.\"", "operationId": "get_visma_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_visma_customers": { "post": { "summary": "Get customer records from Visma Net ERP. Returns customer name, number, contact info, and balance. Use for customer lookups or answering \"who are our Visma customers?\"", "description": "Get customer records from Visma Net ERP. Returns customer name, number, contact info, and balance. Use for customer lookups or answering \"who are our Visma customers?\"", "operationId": "get_visma_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_visma_suppliers": { "post": { "summary": "Get supplier records from Visma Net ERP. Returns supplier name, number, contact info, and payment terms. Use for vendor management or answering \"list Visma suppliers.\"", "description": "Get supplier records from Visma Net ERP. Returns supplier name, number, contact info, and payment terms. Use for vendor management or answering \"list Visma suppliers.\"", "operationId": "get_visma_suppliers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_visma_items": { "post": { "summary": "Get inventory items from Visma Net ERP. Returns item name, number, price, stock quantity, and warehouse info. Use for inventory management or answering \"what items are in Visma?\" or \"check stock levels.\"", "description": "Get inventory items from Visma Net ERP. Returns item name, number, price, stock quantity, and warehouse info. Use for inventory management or answering \"what items are in Visma?\" or \"check stock levels.\"", "operationId": "get_visma_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_xero_invoices": { "post": { "summary": "Get invoices from Xero cloud accounting. Returns invoice number, contact, amount, currency, due date, status, and line items. Use for billing review or answering \"show Xero invoices\" or \"what is outstanding?\"", "description": "Get invoices from Xero cloud accounting. Returns invoice number, contact, amount, currency, due date, status, and line items. Use for billing review or answering \"show Xero invoices\" or \"what is outstanding?\"", "operationId": "get_xero_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_xero_contacts": { "post": { "summary": "Get contacts (customers and suppliers) from Xero accounting. Returns contact name, email, phone, account number, and outstanding balance. Use for contact lookups or answering \"who are our Xero contacts?\"", "description": "Get contacts (customers and suppliers) from Xero accounting. Returns contact name, email, phone, account number, and outstanding balance. Use for contact lookups or answering \"who are our Xero contacts?\"", "operationId": "get_xero_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_xero_items": { "post": { "summary": "Get items\/products from Xero inventory. Returns item code, description, unit price, purchase price, and tracked status. Use for product catalog or answering \"what items are in Xero?\"", "description": "Get items\/products from Xero inventory. Returns item code, description, unit price, purchase price, and tracked status. Use for product catalog or answering \"what items are in Xero?\"", "operationId": "get_xero_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_xero_accounts": { "post": { "summary": "Get chart of accounts from Xero accounting. Returns account name, code, type (revenue, expense, asset, liability), tax type, and status. Use for bookkeeping or answering \"show Xero chart of accounts\" or \"list account categories.\"", "description": "Get chart of accounts from Xero accounting. Returns account name, code, type (revenue, expense, asset, liability), tax type, and status. Use for bookkeeping or answering \"show Xero chart of accounts\" or \"list account categories.\"", "operationId": "get_xero_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sage_invoices": { "post": { "summary": "Get sales invoices from Sage accounting software. Returns invoice number, customer, amount, currency, date, and payment status. Use for billing review or answering \"show Sage invoices.\"", "description": "Get sales invoices from Sage accounting software. Returns invoice number, customer, amount, currency, date, and payment status. Use for billing review or answering \"show Sage invoices.\"", "operationId": "get_sage_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sage_contacts": { "post": { "summary": "Get contacts from Sage accounting. Returns contact name, type, email, phone, and balance. Use for contact lookups or answering \"who are our Sage contacts?\"", "description": "Get contacts from Sage accounting. Returns contact name, type, email, phone, and balance. Use for contact lookups or answering \"who are our Sage contacts?\"", "operationId": "get_sage_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sage_products": { "post": { "summary": "Get products from Sage accounting catalog. Returns product name, code, price, cost, and stock level. Use for product management or answering \"what products are in Sage?\"", "description": "Get products from Sage accounting catalog. Returns product name, code, price, cost, and stock level. Use for product management or answering \"what products are in Sage?\"", "operationId": "get_sage_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sage_purchases": { "post": { "summary": "Get purchase invoices from Sage accounting. Returns supplier, invoice number, amount, date, and payment status. Use for expense tracking or answering \"show purchase invoices\" or \"what do we owe?\"", "description": "Get purchase invoices from Sage accounting. Returns supplier, invoice number, amount, date, and payment status. Use for expense tracking or answering \"show purchase invoices\" or \"what do we owe?\"", "operationId": "get_sage_purchases", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quickbooks_invoices": { "post": { "summary": "Get invoices from QuickBooks cloud accounting. Returns invoice number, customer, amount, balance due, due date, and status. Use for billing review or answering \"show QuickBooks invoices\" or \"what is unpaid?\"", "description": "Get invoices from QuickBooks cloud accounting. Returns invoice number, customer, amount, balance due, due date, and status. Use for billing review or answering \"show QuickBooks invoices\" or \"what is unpaid?\"", "operationId": "get_quickbooks_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quickbooks_customers": { "post": { "summary": "Get customer records from QuickBooks accounting. Returns customer name, email, phone, balance, and payment terms. Use for customer lookups or answering \"who are our QuickBooks customers?\"", "description": "Get customer records from QuickBooks accounting. Returns customer name, email, phone, balance, and payment terms. Use for customer lookups or answering \"who are our QuickBooks customers?\"", "operationId": "get_quickbooks_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quickbooks_items": { "post": { "summary": "Get items\/products from QuickBooks. Returns item name, type, price, cost, quantity on hand, and income account. Use for product catalog or answering \"what items are in QuickBooks?\"", "description": "Get items\/products from QuickBooks. Returns item name, type, price, cost, quantity on hand, and income account. Use for product catalog or answering \"what items are in QuickBooks?\"", "operationId": "get_quickbooks_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quickbooks_vendors": { "post": { "summary": "Get vendor\/supplier records from QuickBooks accounting. Returns vendor name, email, phone, balance owed, and payment terms. Use for vendor management or answering \"who are our QuickBooks vendors?\" or \"what do we owe suppliers?\"", "description": "Get vendor\/supplier records from QuickBooks accounting. Returns vendor name, email, phone, balance owed, and payment terms. Use for vendor management or answering \"who are our QuickBooks vendors?\" or \"what do we owe suppliers?\"", "operationId": "get_quickbooks_vendors", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zohobooks_invoices": { "post": { "summary": "Get invoices from Zoho Books cloud accounting. Returns invoice number, customer, amount, status (sent, draft, overdue, paid), due date, and balance. Filter by status. Use for billing review or answering \"show Zoho invoices\" or \"what invoices are overdue?\"", "description": "Get invoices from Zoho Books cloud accounting. Returns invoice number, customer, amount, status (sent, draft, overdue, paid), due date, and balance. Filter by status. Use for billing review or answering \"show Zoho invoices\" or \"what invoices are overdue?\"", "operationId": "get_zohobooks_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "status": { "type": "string", "description": "Filter by status (e.g., sent, draft, overdue, paid)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zohobooks_contacts": { "post": { "summary": "Get contacts (customers\/vendors) from Zoho Books. Returns contact name, type, email, phone, and outstanding balance. Use for contact lookups or answering \"who are our Zoho Books contacts?\"", "description": "Get contacts (customers\/vendors) from Zoho Books. Returns contact name, type, email, phone, and outstanding balance. Use for contact lookups or answering \"who are our Zoho Books contacts?\"", "operationId": "get_zohobooks_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zohobooks_items": { "post": { "summary": "Get items\/products from Zoho Books inventory. Returns item name, SKU, rate, purchase price, and stock on hand. Use for product catalog or answering \"what items are in Zoho Books?\"", "description": "Get items\/products from Zoho Books inventory. Returns item name, SKU, rate, purchase price, and stock on hand. Use for product catalog or answering \"what items are in Zoho Books?\"", "operationId": "get_zohobooks_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zohobooks_bills": { "post": { "summary": "Get bills (purchase invoices from vendors) from Zoho Books. Returns vendor name, bill number, amount, date, due date, and payment status. Use for expense tracking or answering \"show our bills\" or \"what do we owe vendors?\"", "description": "Get bills (purchase invoices from vendors) from Zoho Books. Returns vendor name, bill number, amount, date, due date, and payment status. Use for expense tracking or answering \"show our bills\" or \"what do we owe vendors?\"", "operationId": "get_zohobooks_bills", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freshbooks_invoices": { "post": { "summary": "Get invoices from FreshBooks cloud accounting. Returns invoice number, client, amount, status (draft, sent, viewed, paid), due date, and outstanding amount. Filter by status. Use for billing review or answering \"show FreshBooks invoices\" or \"what is unpaid?\"", "description": "Get invoices from FreshBooks cloud accounting. Returns invoice number, client, amount, status (draft, sent, viewed, paid), due date, and outstanding amount. Filter by status. Use for billing review or answering \"show FreshBooks invoices\" or \"what is unpaid?\"", "operationId": "get_freshbooks_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "status": { "type": "string", "description": "Filter by status (e.g., draft, sent, viewed, paid)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freshbooks_clients": { "post": { "summary": "Get client records from FreshBooks accounting. Returns client name, email, organization, phone, and outstanding balance. Use for client lookups or answering \"who are our FreshBooks clients?\"", "description": "Get client records from FreshBooks accounting. Returns client name, email, organization, phone, and outstanding balance. Use for client lookups or answering \"who are our FreshBooks clients?\"", "operationId": "get_freshbooks_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freshbooks_expenses": { "post": { "summary": "Get expense records from FreshBooks. Returns expense amount, category, vendor, date, and receipt status. Use for expense tracking or answering \"show our expenses\" or \"what have we spent?\"", "description": "Get expense records from FreshBooks. Returns expense amount, category, vendor, date, and receipt status. Use for expense tracking or answering \"show our expenses\" or \"what have we spent?\"", "operationId": "get_freshbooks_expenses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freshbooks_payments": { "post": { "summary": "Get payment records from FreshBooks. Returns payment amount, client, invoice, date, and payment method. Use for payment tracking or answering \"what payments have we received?\" or \"show FreshBooks payments.\"", "description": "Get payment records from FreshBooks. Returns payment amount, client, invoice, date, and payment method. Use for payment tracking or answering \"what payments have we received?\" or \"show FreshBooks payments.\"", "operationId": "get_freshbooks_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zoho_desk_tickets": { "post": { "summary": "Get support tickets from Zoho Desk helpdesk. Returns ticket number, subject, status (Open, Closed, On Hold), priority, requester, assignee, and dates. Filter by status. Use for support monitoring or answering \"what tickets are open?\", \"show support queue\", or \"how many unresolved tickets?\"", "description": "Get support tickets from Zoho Desk helpdesk. Returns ticket number, subject, status (Open, Closed, On Hold), priority, requester, assignee, and dates. Filter by status. Use for support monitoring or answering \"what tickets are open?\", \"show support queue\", or \"how many unresolved tickets?\"", "operationId": "get_zoho_desk_tickets", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "status": { "type": "string", "description": "Filter by status (e.g., Open, Closed, On Hold)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zoho_desk_contacts": { "post": { "summary": "Get contact records from Zoho Desk. Returns contact name, email, phone, account, and ticket count. Use for customer support lookups or answering \"find support contact\" or \"who submitted tickets?\"", "description": "Get contact records from Zoho Desk. Returns contact name, email, phone, account, and ticket count. Use for customer support lookups or answering \"find support contact\" or \"who submitted tickets?\"", "operationId": "get_zoho_desk_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zoho_desk_accounts": { "post": { "summary": "Get customer account\/organization records from Zoho Desk. Returns account name, industry, website, and associated contacts\/tickets. Use for account overview or answering \"what accounts are in Zoho Desk?\"", "description": "Get customer account\/organization records from Zoho Desk. Returns account name, industry, website, and associated contacts\/tickets. Use for account overview or answering \"what accounts are in Zoho Desk?\"", "operationId": "get_zoho_desk_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zoho_desk_agents": { "post": { "summary": "Get support agent records from Zoho Desk. Returns agent name, email, role, department, and online status. Use for team management or answering \"who are our support agents?\" or \"show Zoho Desk team.\"", "description": "Get support agent records from Zoho Desk. Returns agent name, email, role, department, and online status. Use for team management or answering \"who are our support agents?\" or \"show Zoho Desk team.\"", "operationId": "get_zoho_desk_agents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wave_invoices": { "post": { "summary": "Get invoices from Wave free accounting software. Returns invoice number, customer, amount, status, and due date. Use for billing review or answering \"show Wave invoices\" or \"what is outstanding?\"", "description": "Get invoices from Wave free accounting software. Returns invoice number, customer, amount, status, and due date. Use for billing review or answering \"show Wave invoices\" or \"what is outstanding?\"", "operationId": "get_wave_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wave_customers": { "post": { "summary": "Get customer records from Wave accounting. Returns customer name, email, and outstanding balance. Use for customer lookups or answering \"who are our Wave customers?\"", "description": "Get customer records from Wave accounting. Returns customer name, email, and outstanding balance. Use for customer lookups or answering \"who are our Wave customers?\"", "operationId": "get_wave_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wave_accounts": { "post": { "summary": "Get chart of accounts from Wave accounting. Returns account name, type, subtype, and balance. Use for bookkeeping or answering \"show Wave chart of accounts.\"", "description": "Get chart of accounts from Wave accounting. Returns account name, type, subtype, and balance. Use for bookkeeping or answering \"show Wave chart of accounts.\"", "operationId": "get_wave_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_wave_products": { "post": { "summary": "Get products\/items from Wave accounting catalog. Returns product name, price, and description. Use for product review or answering \"what products are in Wave?\"", "description": "Get products\/items from Wave accounting catalog. Returns product name, price, and description. Use for product review or answering \"what products are in Wave?\"", "operationId": "get_wave_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_moneybird_invoices": { "post": { "summary": "Get invoices from Moneybird Dutch online accounting. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show Moneybird invoices.\"", "description": "Get invoices from Moneybird Dutch online accounting. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show Moneybird invoices.\"", "operationId": "get_moneybird_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_moneybird_contacts": { "post": { "summary": "Get contacts from Moneybird accounting. Returns contact name, company, email, phone, and tax number. Use for contact lookups or answering \"who are our Moneybird contacts?\"", "description": "Get contacts from Moneybird accounting. Returns contact name, company, email, phone, and tax number. Use for contact lookups or answering \"who are our Moneybird contacts?\"", "operationId": "get_moneybird_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_moneybird_payments": { "post": { "summary": "Get payment records from Moneybird. Returns payment amount, date, invoice reference, and method. Use for payment tracking or answering \"show Moneybird payments.\"", "description": "Get payment records from Moneybird. Returns payment amount, date, invoice reference, and method. Use for payment tracking or answering \"show Moneybird payments.\"", "operationId": "get_moneybird_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_moneybird_products": { "post": { "summary": "Get products from Moneybird accounting catalog. Returns product description, price, tax rate, and ledger account. Use for product review or answering \"what products are in Moneybird?\"", "description": "Get products from Moneybird accounting catalog. Returns product description, price, tax rate, and ledger account. Use for product review or answering \"what products are in Moneybird?\"", "operationId": "get_moneybird_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bexio_invoices": { "post": { "summary": "Get invoices from bexio Swiss business software. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show bexio invoices.\"", "description": "Get invoices from bexio Swiss business software. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show bexio invoices.\"", "operationId": "get_bexio_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bexio_contacts": { "post": { "summary": "Get contacts from bexio. Returns contact name, company, email, phone, and address. Use for contact lookups or answering \"who are our bexio contacts?\"", "description": "Get contacts from bexio. Returns contact name, company, email, phone, and address. Use for contact lookups or answering \"who are our bexio contacts?\"", "operationId": "get_bexio_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bexio_products": { "post": { "summary": "Get products\/articles from bexio. Returns product name, article number, unit price, and stock. Use for product management or answering \"what products are in bexio?\"", "description": "Get products\/articles from bexio. Returns product name, article number, unit price, and stock. Use for product management or answering \"what products are in bexio?\"", "operationId": "get_bexio_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_bexio_orders": { "post": { "summary": "Get orders from bexio. Returns order number, customer, items, amount, and status. Use for order tracking or answering \"show bexio orders.\"", "description": "Get orders from bexio. Returns order number, customer, items, amount, and status. Use for order tracking or answering \"show bexio orders.\"", "operationId": "get_bexio_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lexware_invoices": { "post": { "summary": "Get invoices from Lexware German accounting software. Returns invoice number, customer, amount, status, and dates. Use for billing review or answering \"show Lexware invoices.\"", "description": "Get invoices from Lexware German accounting software. Returns invoice number, customer, amount, status, and dates. Use for billing review or answering \"show Lexware invoices.\"", "operationId": "get_lexware_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lexware_contacts": { "post": { "summary": "Get contacts from Lexware. Returns contact name, company, email, tax number, and address. Use for contact lookups or answering \"who are our Lexware contacts?\"", "description": "Get contacts from Lexware. Returns contact name, company, email, tax number, and address. Use for contact lookups or answering \"who are our Lexware contacts?\"", "operationId": "get_lexware_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lexware_vouchers": { "post": { "summary": "Get vouchers (receipts\/expense documents) from Lexware. Returns voucher type, amount, date, and document reference. Use for expense documentation or answering \"show Lexware vouchers\" or \"check receipts.\"", "description": "Get vouchers (receipts\/expense documents) from Lexware. Returns voucher type, amount, date, and document reference. Use for expense documentation or answering \"show Lexware vouchers\" or \"check receipts.\"", "operationId": "get_lexware_vouchers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_lexware_quotations": { "post": { "summary": "Get quotations\/estimates from Lexware. Returns quote number, customer, amount, validity date, and status. Use for quote tracking or answering \"show our quotations\" or \"what quotes are pending?\"", "description": "Get quotations\/estimates from Lexware. Returns quote number, customer, amount, validity date, and status. Use for quote tracking or answering \"show our quotations\" or \"what quotes are pending?\"", "operationId": "get_lexware_quotations", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freeagent_invoices": { "post": { "summary": "Get invoices from FreeAgent UK accounting software. Returns invoice number, client, amount, status, due date, and currency. Use for billing review or answering \"show FreeAgent invoices.\"", "description": "Get invoices from FreeAgent UK accounting software. Returns invoice number, client, amount, status, due date, and currency. Use for billing review or answering \"show FreeAgent invoices.\"", "operationId": "get_freeagent_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freeagent_contacts": { "post": { "summary": "Get contacts from FreeAgent. Returns contact name, organisation, email, phone, and status. Use for contact lookups or answering \"who are our FreeAgent contacts?\"", "description": "Get contacts from FreeAgent. Returns contact name, organisation, email, phone, and status. Use for contact lookups or answering \"who are our FreeAgent contacts?\"", "operationId": "get_freeagent_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freeagent_expenses": { "post": { "summary": "Get expense claims from FreeAgent. Returns expense description, amount, category, date, and receipt status. Use for expense tracking or answering \"show our expenses\" or \"what claims are pending?\"", "description": "Get expense claims from FreeAgent. Returns expense description, amount, category, date, and receipt status. Use for expense tracking or answering \"show our expenses\" or \"what claims are pending?\"", "operationId": "get_freeagent_expenses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_freeagent_bills": { "post": { "summary": "Get bills (supplier invoices) from FreeAgent. Returns bill reference, supplier, amount, due date, and payment status. Use for expense management or answering \"show FreeAgent bills\" or \"what do we owe?\"", "description": "Get bills (supplier invoices) from FreeAgent. Returns bill reference, supplier, amount, due date, and payment status. Use for expense management or answering \"show FreeAgent bills\" or \"what do we owe?\"", "operationId": "get_freeagent_bills", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fattureincloud_invoices": { "post": { "summary": "Get invoices from Fatture in Cloud Italian electronic invoicing platform. Returns invoice number, customer, amount, date, and e-invoicing status. Use for billing review or answering \"show Fatture in Cloud invoices.\"", "description": "Get invoices from Fatture in Cloud Italian electronic invoicing platform. Returns invoice number, customer, amount, date, and e-invoicing status. Use for billing review or answering \"show Fatture in Cloud invoices.\"", "operationId": "get_fattureincloud_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fattureincloud_clients": { "post": { "summary": "Get client records from Fatture in Cloud. Returns client name, VAT number (partita IVA), fiscal code, email, and address. Use for client lookups or answering \"who are our clients in Fatture in Cloud?\"", "description": "Get client records from Fatture in Cloud. Returns client name, VAT number (partita IVA), fiscal code, email, and address. Use for client lookups or answering \"who are our clients in Fatture in Cloud?\"", "operationId": "get_fattureincloud_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fattureincloud_suppliers": { "post": { "summary": "Get supplier records from Fatture in Cloud. Returns supplier name, VAT number, contact info, and address. Use for vendor management or answering \"list our Fatture in Cloud suppliers.\"", "description": "Get supplier records from Fatture in Cloud. Returns supplier name, VAT number, contact info, and address. Use for vendor management or answering \"list our Fatture in Cloud suppliers.\"", "operationId": "get_fattureincloud_suppliers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fattureincloud_products": { "post": { "summary": "Get products from Fatture in Cloud catalog. Returns product name, code, unit price, VAT rate, and category. Use for product management or answering \"what products are in Fatture in Cloud?\"", "description": "Get products from Fatture in Cloud catalog. Returns product name, code, unit price, VAT rate, and category. Use for product management or answering \"what products are in Fatture in Cloud?\"", "operationId": "get_fattureincloud_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pennylane_invoices": { "post": { "summary": "Get invoices from Pennylane French accounting platform. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show Pennylane invoices.\"", "description": "Get invoices from Pennylane French accounting platform. Returns invoice number, customer, amount, currency, status, and dates. Use for billing review or answering \"show Pennylane invoices.\"", "operationId": "get_pennylane_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pennylane_customers": { "post": { "summary": "Get customer records from Pennylane. Returns customer name, SIREN number, email, and balance. Use for customer lookups or answering \"who are our Pennylane customers?\"", "description": "Get customer records from Pennylane. Returns customer name, SIREN number, email, and balance. Use for customer lookups or answering \"who are our Pennylane customers?\"", "operationId": "get_pennylane_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pennylane_suppliers": { "post": { "summary": "Get supplier records from Pennylane. Returns supplier name, SIREN number, contact info, and payment terms. Use for vendor management or answering \"list Pennylane suppliers.\"", "description": "Get supplier records from Pennylane. Returns supplier name, SIREN number, contact info, and payment terms. Use for vendor management or answering \"list Pennylane suppliers.\"", "operationId": "get_pennylane_suppliers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_pennylane_products": { "post": { "summary": "Get products from Pennylane accounting catalog. Returns product name, price, VAT rate, and unit. Use for product review or answering \"what products are in Pennylane?\"", "description": "Get products from Pennylane accounting catalog. Returns product name, price, VAT rate, and unit. Use for product review or answering \"what products are in Pennylane?\"", "operationId": "get_pennylane_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_revolut_accounts": { "post": { "summary": "Get bank accounts from Revolut Business. Returns account name, currency, balance, and status. Use for treasury overview or answering \"what are our Revolut account balances?\" or \"show business bank accounts.\"", "description": "Get bank accounts from Revolut Business. Returns account name, currency, balance, and status. Use for treasury overview or answering \"what are our Revolut account balances?\" or \"show business bank accounts.\"", "operationId": "get_revolut_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_revolut_transactions": { "post": { "summary": "Get transaction history from Revolut Business. Returns transaction amount, currency, counterparty, type, status, and date. Use for transaction review or answering \"show recent Revolut transactions\" or \"what payments were made?\"", "description": "Get transaction history from Revolut Business. Returns transaction amount, currency, counterparty, type, status, and date. Use for transaction review or answering \"show recent Revolut transactions\" or \"what payments were made?\"", "operationId": "get_revolut_transactions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_revolut_counterparties": { "post": { "summary": "Get saved counterparties (payment recipients) from Revolut Business. Returns counterparty name, account details, and currency. Use for payment recipient lookups or answering \"who can we pay via Revolut?\" or \"show saved beneficiaries.\"", "description": "Get saved counterparties (payment recipients) from Revolut Business. Returns counterparty name, account details, and currency. Use for payment recipient lookups or answering \"who can we pay via Revolut?\" or \"show saved beneficiaries.\"", "operationId": "get_revolut_counterparties", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_revolut_payments": { "post": { "summary": "Get payment records from Revolut Business. Returns payment amount, currency, recipient, status, and date. Use for payment tracking or answering \"show Revolut payments\" or \"what transfers were made?\"", "description": "Get payment records from Revolut Business. Returns payment amount, currency, recipient, status, and date. Use for payment tracking or answering \"show Revolut payments\" or \"what transfers were made?\"", "operationId": "get_revolut_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_qonto_transactions": { "post": { "summary": "Get transactions from Qonto European business banking. Returns transaction amount, currency, counterparty, category, and date. Use for banking review or answering \"show Qonto transactions\" or \"what were our recent payments?\"", "description": "Get transactions from Qonto European business banking. Returns transaction amount, currency, counterparty, category, and date. Use for banking review or answering \"show Qonto transactions\" or \"what were our recent payments?\"", "operationId": "get_qonto_transactions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_qonto_members": { "post": { "summary": "Get team members from Qonto business account. Returns member name, role, card status, and spending limits. Use for team finance management or answering \"who has Qonto access?\" or \"show team members.\"", "description": "Get team members from Qonto business account. Returns member name, role, card status, and spending limits. Use for team finance management or answering \"who has Qonto access?\" or \"show team members.\"", "operationId": "get_qonto_members", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_qonto_labels": { "post": { "summary": "Get labels\/categories from Qonto for transaction organization. Returns label name, color, and usage count. Use for transaction categorization or answering \"what Qonto labels do we use?\"", "description": "Get labels\/categories from Qonto for transaction organization. Returns label name, color, and usage count. Use for transaction categorization or answering \"what Qonto labels do we use?\"", "operationId": "get_qonto_labels", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gorgias_tickets": { "post": { "summary": "Get support tickets from Gorgias e-commerce helpdesk. Returns ticket subject, customer, channel (email, chat, social), status, priority, and dates. Use for support monitoring or answering \"what tickets are open?\", \"show support queue\", or \"how many unresolved tickets?\"", "description": "Get support tickets from Gorgias e-commerce helpdesk. Returns ticket subject, customer, channel (email, chat, social), status, priority, and dates. Use for support monitoring or answering \"what tickets are open?\", \"show support queue\", or \"how many unresolved tickets?\"", "operationId": "get_gorgias_tickets", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gorgias_customers": { "post": { "summary": "Get customer records from Gorgias helpdesk. Returns customer name, email, order count, ticket history, and lifetime value. Use for customer support context or answering \"find customer support history\" or \"who are our frequent support contacts?\"", "description": "Get customer records from Gorgias helpdesk. Returns customer name, email, order count, ticket history, and lifetime value. Use for customer support context or answering \"find customer support history\" or \"who are our frequent support contacts?\"", "operationId": "get_gorgias_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gorgias_tags": { "post": { "summary": "Get tags used in Gorgias for ticket categorization. Returns tag name and usage count. Use for support analytics or answering \"what ticket categories do we use?\" or \"show Gorgias tags.\"", "description": "Get tags used in Gorgias for ticket categorization. Returns tag name and usage count. Use for support analytics or answering \"what ticket categories do we use?\" or \"show Gorgias tags.\"", "operationId": "get_gorgias_tags", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_gorgias_rules": { "post": { "summary": "Get automation rules from Gorgias. Returns rule name, conditions, actions, and status. Use for support workflow review or answering \"what automations are set up?\" or \"show Gorgias automation rules.\"", "description": "Get automation rules from Gorgias. Returns rule name, conditions, actions, and status. Use for support workflow review or answering \"what automations are set up?\" or \"show Gorgias automation rules.\"", "operationId": "get_gorgias_rules", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_servicenow_incidents": { "post": { "summary": "Get IT incidents from ServiceNow ITSM platform. Returns incident number, description, priority, state, assigned to, category, and resolution time. Use for IT service monitoring or answering \"what incidents are open?\", \"show P1 incidents\", or \"how many unresolved issues?\"", "description": "Get IT incidents from ServiceNow ITSM platform. Returns incident number, description, priority, state, assigned to, category, and resolution time. Use for IT service monitoring or answering \"what incidents are open?\", \"show P1 incidents\", or \"how many unresolved issues?\"", "operationId": "get_servicenow_incidents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_servicenow_changes": { "post": { "summary": "Get change requests from ServiceNow. Returns change number, description, type (normal, standard, emergency), state, risk, and implementation date. Use for change management or answering \"what changes are pending?\", \"show approved changes\", or \"list upcoming deployments.\"", "description": "Get change requests from ServiceNow. Returns change number, description, type (normal, standard, emergency), state, risk, and implementation date. Use for change management or answering \"what changes are pending?\", \"show approved changes\", or \"list upcoming deployments.\"", "operationId": "get_servicenow_changes", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_servicenow_users": { "post": { "summary": "Get user records from ServiceNow. Returns user name, email, department, role, and active status. Use for IT user management or answering \"who are the ServiceNow users?\" or \"find user details.\"", "description": "Get user records from ServiceNow. Returns user name, email, department, role, and active status. Use for IT user management or answering \"who are the ServiceNow users?\" or \"find user details.\"", "operationId": "get_servicenow_users", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_servicenow_problems": { "post": { "summary": "Get problem records from ServiceNow. Returns problem number, description, priority, state, root cause, and related incidents. Use for problem management or answering \"what known problems exist?\", \"show root cause analysis\", or \"list unresolved problems.\"", "description": "Get problem records from ServiceNow. Returns problem number, description, priority, state, root cause, and related incidents. Use for problem management or answering \"what known problems exist?\", \"show root cause analysis\", or \"list unresolved problems.\"", "operationId": "get_servicenow_problems", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/niftyquoter_get_clients": { "post": { "summary": "Get clients from NiftyQuoter proposal software. Returns client name, email, business name, phone, and address. Search by email, business name, first or last name. Use for client lookups or answering \"who are our NiftyQuoter clients?\" or \"find client by email.\"", "description": "Get clients from NiftyQuoter proposal software. Returns client name, email, business name, phone, and address. Search by email, business name, first or last name. Use for client lookups or answering \"who are our NiftyQuoter clients?\" or \"find client by email.\"", "operationId": "niftyquoter_get_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "search_email": { "type": "string", "description": "Filter by email address" }, "business_name": { "type": "string", "description": "Filter by business name" }, "first_name": { "type": "string", "description": "Filter by first name" }, "last_name": { "type": "string", "description": "Filter by last name" }, "page": { "type": "integer", "default": 1 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/niftyquoter_get_proposals": { "post": { "summary": "Get proposals from NiftyQuoter. Returns proposal title, client, amount, state (approve, reject, viewed, sent, not_sent), and dates. Filter by state or date range. Use for proposal tracking or answering \"what proposals are pending?\", \"show approved proposals\", or \"list proposals sent this month.\"", "description": "Get proposals from NiftyQuoter. Returns proposal title, client, amount, state (approve, reject, viewed, sent, not_sent), and dates. Filter by state or date range. Use for proposal tracking or answering \"what proposals are pending?\", \"show approved proposals\", or \"list proposals sent this month.\"", "operationId": "niftyquoter_get_proposals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "approve", "reject", "viewed", "sent", "not_sent" ], "description": "Filter by proposal state" }, "date_from": { "type": "string", "description": "Start date filter (YYYY-MM-DD)" }, "date_to": { "type": "string", "description": "End date filter (YYYY-MM-DD)" }, "page": { "type": "integer", "default": 1 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/niftyquoter_get_proposal": { "post": { "summary": "Get full details of a specific NiftyQuoter proposal by ID. Returns complete proposal content, line items, pricing, client info, and signing status. Use for reviewing a specific proposal or answering \"show me proposal #123\" or \"what is in this proposal?\"", "description": "Get full details of a specific NiftyQuoter proposal by ID. Returns complete proposal content, line items, pricing, client info, and signing status. Use for reviewing a specific proposal or answering \"show me proposal #123\" or \"what is in this proposal?\"", "operationId": "niftyquoter_get_proposal", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "proposal_id": { "type": "integer", "description": "The proposal ID" } }, "required": [ "proposal_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/niftyquoter_get_templates": { "post": { "summary": "Get pricing and service templates from NiftyQuoter. Returns template names, descriptions, and pricing structures. Use for template discovery or answering \"what proposal templates do we have?\" or \"show our pricing templates.\"", "description": "Get pricing and service templates from NiftyQuoter. Returns template names, descriptions, and pricing structures. Use for template discovery or answering \"what proposal templates do we have?\" or \"show our pricing templates.\"", "operationId": "niftyquoter_get_templates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/better_proposals_get_proposals": { "post": { "summary": "Get all proposals from Better Proposals platform. Returns proposal title, client, status, amount, and dates. Use for proposal overview or answering \"what proposals do we have?\" or \"show Better Proposals status.\"", "description": "Get all proposals from Better Proposals platform. Returns proposal title, client, status, amount, and dates. Use for proposal overview or answering \"what proposals do we have?\" or \"show Better Proposals status.\"", "operationId": "better_proposals_get_proposals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/better_proposals_get_proposal": { "post": { "summary": "Get full details of a specific Better Proposals proposal by ID. Returns complete proposal content, sections, pricing, client info, and viewing\/signing analytics. Use for reviewing a specific proposal.", "description": "Get full details of a specific Better Proposals proposal by ID. Returns complete proposal content, sections, pricing, client info, and viewing\/signing analytics. Use for reviewing a specific proposal.", "operationId": "better_proposals_get_proposal", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "proposal_id": { "type": "string", "description": "The proposal ID" } }, "required": [ "proposal_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/better_proposals_get_companies": { "post": { "summary": "Get all company records from Better Proposals. Returns company name, contact info, and associated proposals. Use for company lookups or answering \"what companies are in Better Proposals?\"", "description": "Get all company records from Better Proposals. Returns company name, contact info, and associated proposals. Use for company lookups or answering \"what companies are in Better Proposals?\"", "operationId": "better_proposals_get_companies", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/better_proposals_get_templates": { "post": { "summary": "Get all proposal templates from Better Proposals. Returns template name, category, and description. Use for template discovery or answering \"what templates are available?\"", "description": "Get all proposal templates from Better Proposals. Returns template name, category, and description. Use for template discovery or answering \"what templates are available?\"", "operationId": "better_proposals_get_templates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/proposify_get_documents": { "post": { "summary": "Get proposals\/documents from Proposify document automation platform. Returns document title, client, status, value, and dates. Filter by status with pagination. Use for proposal tracking or answering \"what proposals are in Proposify?\" or \"show sent proposals.\"", "description": "Get proposals\/documents from Proposify document automation platform. Returns document title, client, status, value, and dates. Filter by status with pagination. Use for proposal tracking or answering \"what proposals are in Proposify?\" or \"show sent proposals.\"", "operationId": "proposify_get_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "description": "Filter by document status" }, "limit": { "type": "integer", "default": 20 }, "offset": { "type": "integer", "description": "Offset for pagination" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/proposify_get_document": { "post": { "summary": "Get full details of a specific Proposify document\/proposal by ID. Returns complete document content, sections, pricing tables, client info, and e-signature status. Use for reviewing a specific proposal.", "description": "Get full details of a specific Proposify document\/proposal by ID. Returns complete document content, sections, pricing tables, client info, and e-signature status. Use for reviewing a specific proposal.", "operationId": "proposify_get_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "document_id": { "type": "string", "description": "The document ID" } }, "required": [ "document_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/proposify_get_clients": { "post": { "summary": "Get client records from Proposify. Returns client name, company, email, and associated documents. Use for client lookups or answering \"who are our Proposify clients?\"", "description": "Get client records from Proposify. Returns client name, company, email, and associated documents. Use for client lookups or answering \"who are our Proposify clients?\"", "operationId": "proposify_get_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/proposify_get_templates": { "post": { "summary": "Get document templates from Proposify. Returns template name, category, and description. Use for template discovery or answering \"what Proposify templates are available?\"", "description": "Get document templates from Proposify. Returns template name, category, and description. Use for template discovery or answering \"what Proposify templates are available?\"", "operationId": "proposify_get_templates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/qwilr_get_pages": { "post": { "summary": "Get proposal pages from Qwilr interactive document platform. Returns page title, status, client, created date, and view count. Filter by status with pagination. Use for proposal tracking or answering \"what Qwilr pages do we have?\" or \"show proposal status.\"", "description": "Get proposal pages from Qwilr interactive document platform. Returns page title, status, client, created date, and view count. Filter by status with pagination. Use for proposal tracking or answering \"what Qwilr pages do we have?\" or \"show proposal status.\"", "operationId": "qwilr_get_pages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Number of pages to return", "default": 20 }, "offset": { "type": "integer", "description": "Offset for pagination" }, "status": { "type": "string", "description": "Filter by page status" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/qwilr_get_page": { "post": { "summary": "Get full details of a specific Qwilr page\/proposal by ID. Returns page content, design, pricing, acceptance status, and sharing URL. Use for reviewing a specific interactive proposal.", "description": "Get full details of a specific Qwilr page\/proposal by ID. Returns page content, design, pricing, acceptance status, and sharing URL. Use for reviewing a specific interactive proposal.", "operationId": "qwilr_get_page", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "page_id": { "type": "string", "description": "The page ID" } }, "required": [ "page_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/qwilr_get_blocks": { "post": { "summary": "Get content blocks of a Qwilr page \u2014 the individual sections that make up the proposal (text, images, pricing tables, embeds, etc.). Returns block type, content, and order. Use for detailed proposal content review.", "description": "Get content blocks of a Qwilr page \u2014 the individual sections that make up the proposal (text, images, pricing tables, embeds, etc.). Returns block type, content, and order. Use for detailed proposal content review.", "operationId": "qwilr_get_blocks", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "page_id": { "type": "string", "description": "The page ID" } }, "required": [ "page_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/qwilr_get_analytics": { "post": { "summary": "Get viewing analytics for a Qwilr proposal page. Returns view count, unique visitors, time spent per section, and engagement metrics. Use for proposal engagement tracking or answering \"has the client viewed our proposal?\", \"how long did they spend on it?\", or \"which sections got the most attention?\"", "description": "Get viewing analytics for a Qwilr proposal page. Returns view count, unique visitors, time spent per section, and engagement metrics. Use for proposal engagement tracking or answering \"has the client viewed our proposal?\", \"how long did they spend on it?\", or \"which sections got the most attention?\"", "operationId": "qwilr_get_analytics", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "page_id": { "type": "string", "description": "The page ID" } }, "required": [ "page_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sevdesk_invoices": { "post": { "summary": "Get sales invoices from sevDesk German cloud accounting. Returns invoice number, client name, date, due date, total (gross), currency, and status (draft\/delivered\/open\/paid). Filter unpaid_only=true for outstanding invoices. Use for financial reporting or answering \"show me unpaid invoices\" or \"list recent sevDesk invoices.\"", "description": "Get sales invoices from sevDesk German cloud accounting. Returns invoice number, client name, date, due date, total (gross), currency, and status (draft\/delivered\/open\/paid). Filter unpaid_only=true for outstanding invoices. Use for financial reporting or answering \"show me unpaid invoices\" or \"list recent sevDesk invoices.\"", "operationId": "get_sevdesk_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "unpaid_only": { "type": "boolean", "default": false } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sevdesk_contacts": { "post": { "summary": "Get contacts from sevDesk accounting. Returns name, email, phone, address, company, and VAT number. Use for finding client details or answering \"who are our sevDesk contacts?\" or \"find contact info.\"", "description": "Get contacts from sevDesk accounting. Returns name, email, phone, address, company, and VAT number. Use for finding client details or answering \"who are our sevDesk contacts?\" or \"find contact info.\"", "operationId": "get_sevdesk_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sevdesk_transactions": { "post": { "summary": "Get bank account transactions from sevDesk. Returns date, amount, payment purpose\/description, and status. Use for cash flow tracking or answering \"show me recent bank transactions\" or \"what payments came in?\"", "description": "Get bank account transactions from sevDesk. Returns date, amount, payment purpose\/description, and status. Use for cash flow tracking or answering \"show me recent bank transactions\" or \"what payments came in?\"", "operationId": "get_sevdesk_transactions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sevdesk_vouchers": { "post": { "summary": "Get expense vouchers\/receipts from sevDesk. Returns voucher number, supplier name, date, total amount, and status (draft\/unpaid\/paid). Use for expense tracking or answering \"show me expenses\" or \"what vouchers are unpaid?\"", "description": "Get expense vouchers\/receipts from sevDesk. Returns voucher number, supplier name, date, total amount, and status (draft\/unpaid\/paid). Use for expense tracking or answering \"show me expenses\" or \"what vouchers are unpaid?\"", "operationId": "get_sevdesk_vouchers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billomat_invoices": { "post": { "summary": "Get sales invoices from Billomat German invoicing software. Returns invoice number, client name, date, due date, total (gross), currency, and status. Use for invoice management or answering \"show me Billomat invoices\" or \"list recent bills.\"", "description": "Get sales invoices from Billomat German invoicing software. Returns invoice number, client name, date, due date, total (gross), currency, and status. Use for invoice management or answering \"show me Billomat invoices\" or \"list recent bills.\"", "operationId": "get_billomat_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billomat_clients": { "post": { "summary": "Get clients from Billomat. Returns name, company, email, phone, address, and VAT number. Use for client lookups or answering \"who are our Billomat clients?\"", "description": "Get clients from Billomat. Returns name, company, email, phone, address, and VAT number. Use for client lookups or answering \"who are our Billomat clients?\"", "operationId": "get_billomat_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billomat_expenses": { "post": { "summary": "Get incoming invoices\/expenses from Billomat. Returns number, supplier, date, total, currency, and status. Use for expense tracking or answering \"show me incoming invoices\" or \"what expenses do we have?\"", "description": "Get incoming invoices\/expenses from Billomat. Returns number, supplier, date, total, currency, and status. Use for expense tracking or answering \"show me incoming invoices\" or \"what expenses do we have?\"", "operationId": "get_billomat_expenses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_weclapp_contacts": { "post": { "summary": "Get customers from weclapp CRM & ERP platform. Returns name, email, phone, address, and customer number. Use for customer lookups or answering \"show me weclapp customers\" or \"find a customer.\"", "description": "Get customers from weclapp CRM & ERP platform. Returns name, email, phone, address, and customer number. Use for customer lookups or answering \"show me weclapp customers\" or \"find a customer.\"", "operationId": "get_weclapp_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_weclapp_opportunities": { "post": { "summary": "Get sales opportunities from weclapp CRM. Returns opportunity name, value, sales stage, status, and associated contact. Use for pipeline review or answering \"what sales opportunities do we have?\"", "description": "Get sales opportunities from weclapp CRM. Returns opportunity name, value, sales stage, status, and associated contact. Use for pipeline review or answering \"what sales opportunities do we have?\"", "operationId": "get_weclapp_opportunities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_weclapp_invoices": { "post": { "summary": "Get sales invoices from weclapp ERP. Returns invoice number, customer name, date, total amount, currency, and invoice status. Use for financial reporting or answering \"show me weclapp invoices.\"", "description": "Get sales invoices from weclapp ERP. Returns invoice number, customer name, date, total amount, currency, and invoice status. Use for financial reporting or answering \"show me weclapp invoices.\"", "operationId": "get_weclapp_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_weclapp_orders": { "post": { "summary": "Get sales orders from weclapp ERP. Returns order number, customer name, date, total amount, and order status. Use for order tracking or answering \"show me recent orders\" or \"what orders are pending?\"", "description": "Get sales orders from weclapp ERP. Returns order number, customer name, date, total amount, and order status. Use for order tracking or answering \"show me recent orders\" or \"what orders are pending?\"", "operationId": "get_weclapp_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_personio_employees": { "post": { "summary": "Get employees from Personio HR platform. Returns first name, last name, email, department, position, employment type, status, and hire date. Use for HR queries or answering \"list our employees\", \"who works in engineering?\", or \"show me new hires.\"", "description": "Get employees from Personio HR platform. Returns first name, last name, email, department, position, employment type, status, and hire date. Use for HR queries or answering \"list our employees\", \"who works in engineering?\", or \"show me new hires.\"", "operationId": "get_personio_employees", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_personio_employee": { "post": { "summary": "Get a single employee's full details from Personio by ID. Returns all available attributes including personal info, department, position, compensation, and custom fields. Use when you need details about a specific person.", "description": "Get a single employee's full details from Personio by ID. Returns all available attributes including personal info, department, position, compensation, and custom fields. Use when you need details about a specific person.", "operationId": "get_personio_employee", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "employee_id": { "type": "integer", "description": "The Personio employee ID" } }, "required": [ "employee_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_personio_absences": { "post": { "summary": "Get time-off\/absence records from Personio. Returns employee name, absence type (vacation, sick leave, etc.), start\/end dates, days count, and approval status. Use for leave tracking or answering \"who is on vacation?\", \"show me sick leave this month.\"", "description": "Get time-off\/absence records from Personio. Returns employee name, absence type (vacation, sick leave, etc.), start\/end dates, days count, and approval status. Use for leave tracking or answering \"who is on vacation?\", \"show me sick leave this month.\"", "operationId": "get_personio_absences", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_personio_attendances": { "post": { "summary": "Get attendance\/time tracking records from Personio. Returns employee ID, date, start time, end time, break duration, and comments. Use for time tracking or answering \"show me attendance records\" or \"who worked today?\"", "description": "Get attendance\/time tracking records from Personio. Returns employee ID, date, start time, end time, break duration, and comments. Use for time tracking or answering \"show me attendance records\" or \"who worked today?\"", "operationId": "get_personio_attendances", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 }, "start_date": { "type": "string", "format": "date", "description": "Filter from date (YYYY-MM-DD)" }, "end_date": { "type": "string", "format": "date", "description": "Filter to date (YYYY-MM-DD)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_datev_documents": { "post": { "summary": "Get documents from DATEV accounting platform.", "description": "Get documents from DATEV accounting platform.", "operationId": "get_datev_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_datev_clients": { "post": { "summary": "Get client records from DATEV.", "description": "Get client records from DATEV.", "operationId": "get_datev_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_datev_postings": { "post": { "summary": "Get accounting postings from DATEV.", "description": "Get accounting postings from DATEV.", "operationId": "get_datev_postings", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_myfactory_orders": { "post": { "summary": "Get sales orders from Myfactory ERP.", "description": "Get sales orders from Myfactory ERP.", "operationId": "get_myfactory_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_myfactory_products": { "post": { "summary": "Get products from Myfactory ERP.", "description": "Get products from Myfactory ERP.", "operationId": "get_myfactory_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_myfactory_customers": { "post": { "summary": "Get customers from Myfactory ERP.", "description": "Get customers from Myfactory ERP.", "operationId": "get_myfactory_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_myfactory_invoices": { "post": { "summary": "Get invoices from Myfactory ERP.", "description": "Get invoices from Myfactory ERP.", "operationId": "get_myfactory_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_exact_invoices": { "post": { "summary": "Get sales invoices from Exact Online.", "description": "Get sales invoices from Exact Online.", "operationId": "get_exact_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_exact_accounts": { "post": { "summary": "Get CRM accounts from Exact Online.", "description": "Get CRM accounts from Exact Online.", "operationId": "get_exact_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_exact_items": { "post": { "summary": "Get inventory items from Exact Online.", "description": "Get inventory items from Exact Online.", "operationId": "get_exact_items", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_exact_journals": { "post": { "summary": "Get financial journals from Exact Online.", "description": "Get financial journals from Exact Online.", "operationId": "get_exact_journals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamleader_contacts": { "post": { "summary": "Get contacts from Teamleader CRM.", "description": "Get contacts from Teamleader CRM.", "operationId": "get_teamleader_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamleader_companies": { "post": { "summary": "Get companies from Teamleader CRM.", "description": "Get companies from Teamleader CRM.", "operationId": "get_teamleader_companies", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamleader_deals": { "post": { "summary": "Get deals from Teamleader CRM.", "description": "Get deals from Teamleader CRM.", "operationId": "get_teamleader_deals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamleader_invoices": { "post": { "summary": "Get invoices from Teamleader.", "description": "Get invoices from Teamleader.", "operationId": "get_teamleader_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_twinfield_invoices": { "post": { "summary": "Get invoices from Twinfield accounting.", "description": "Get invoices from Twinfield accounting.", "operationId": "get_twinfield_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_twinfield_customers": { "post": { "summary": "Get customers from Twinfield.", "description": "Get customers from Twinfield.", "operationId": "get_twinfield_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_twinfield_ledgers": { "post": { "summary": "Get general ledgers from Twinfield.", "description": "Get general ledgers from Twinfield.", "operationId": "get_twinfield_ledgers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_yuki_invoices": { "post": { "summary": "Get invoices from Yuki accounting.", "description": "Get invoices from Yuki accounting.", "operationId": "get_yuki_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_yuki_contacts": { "post": { "summary": "Get contacts from Yuki.", "description": "Get contacts from Yuki.", "operationId": "get_yuki_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_yuki_documents": { "post": { "summary": "Get documents from Yuki.", "description": "Get documents from Yuki.", "operationId": "get_yuki_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_symfonia_invoices": { "post": { "summary": "Get invoices from Symfonia ERP.", "description": "Get invoices from Symfonia ERP.", "operationId": "get_symfonia_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_symfonia_contractors": { "post": { "summary": "Get contractors from Symfonia.", "description": "Get contractors from Symfonia.", "operationId": "get_symfonia_contractors", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_symfonia_documents": { "post": { "summary": "Get documents from Symfonia.", "description": "Get documents from Symfonia.", "operationId": "get_symfonia_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_comarch_invoices": { "post": { "summary": "Get invoices from Comarch ERP.", "description": "Get invoices from Comarch ERP.", "operationId": "get_comarch_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_comarch_contractors": { "post": { "summary": "Get contractors from Comarch ERP.", "description": "Get contractors from Comarch ERP.", "operationId": "get_comarch_contractors", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_comarch_products": { "post": { "summary": "Get products from Comarch ERP.", "description": "Get products from Comarch ERP.", "operationId": "get_comarch_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_comarch_orders": { "post": { "summary": "Get orders from Comarch ERP.", "description": "Get orders from Comarch ERP.", "operationId": "get_comarch_orders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_holded_invoices": { "post": { "summary": "Get invoices from Holded accounting.", "description": "Get invoices from Holded accounting.", "operationId": "get_holded_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_holded_contacts": { "post": { "summary": "Get contacts from Holded.", "description": "Get contacts from Holded.", "operationId": "get_holded_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_holded_products": { "post": { "summary": "Get products from Holded.", "description": "Get products from Holded.", "operationId": "get_holded_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_holded_expenses": { "post": { "summary": "Get expenses from Holded.", "description": "Get expenses from Holded.", "operationId": "get_holded_expenses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quipu_invoices": { "post": { "summary": "Get invoices from Quipu accounting.", "description": "Get invoices from Quipu accounting.", "operationId": "get_quipu_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quipu_contacts": { "post": { "summary": "Get contacts from Quipu.", "description": "Get contacts from Quipu.", "operationId": "get_quipu_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_quipu_expenses": { "post": { "summary": "Get expenses from Quipu.", "description": "Get expenses from Quipu.", "operationId": "get_quipu_expenses", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamsystem_invoices": { "post": { "summary": "Get invoices from TeamSystem ERP.", "description": "Get invoices from TeamSystem ERP.", "operationId": "get_teamsystem_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamsystem_customers": { "post": { "summary": "Get customers from TeamSystem.", "description": "Get customers from TeamSystem.", "operationId": "get_teamsystem_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_teamsystem_documents": { "post": { "summary": "Get documents from TeamSystem.", "description": "Get documents from TeamSystem.", "operationId": "get_teamsystem_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zucchetti_employees": { "post": { "summary": "Get employees from Zucchetti HR.", "description": "Get employees from Zucchetti HR.", "operationId": "get_zucchetti_employees", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zucchetti_payslips": { "post": { "summary": "Get payslips from Zucchetti.", "description": "Get payslips from Zucchetti.", "operationId": "get_zucchetti_payslips", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_zucchetti_attendance": { "post": { "summary": "Get attendance records from Zucchetti.", "description": "Get attendance records from Zucchetti.", "operationId": "get_zucchetti_attendance", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_cegid_invoices": { "post": { "summary": "Get invoices from Cegid ERP.", "description": "Get invoices from Cegid ERP.", "operationId": "get_cegid_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_cegid_accounts": { "post": { "summary": "Get accounts from Cegid.", "description": "Get accounts from Cegid.", "operationId": "get_cegid_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_cegid_journals": { "post": { "summary": "Get journals from Cegid.", "description": "Get journals from Cegid.", "operationId": "get_cegid_journals", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sellsy_invoices": { "post": { "summary": "Get invoices from Sellsy CRM.", "description": "Get invoices from Sellsy CRM.", "operationId": "get_sellsy_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sellsy_contacts": { "post": { "summary": "Get contacts from Sellsy.", "description": "Get contacts from Sellsy.", "operationId": "get_sellsy_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sellsy_opportunities": { "post": { "summary": "Get opportunities from Sellsy.", "description": "Get opportunities from Sellsy.", "operationId": "get_sellsy_opportunities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sellsy_products": { "post": { "summary": "Get products from Sellsy.", "description": "Get products from Sellsy.", "operationId": "get_sellsy_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_storecove_invoices": { "post": { "summary": "Get e-invoices from Storecove (Peppol).", "description": "Get e-invoices from Storecove (Peppol).", "operationId": "get_storecove_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_storecove_invoice": { "post": { "summary": "Send an e-invoice via Storecove\/Peppol.", "description": "Send an e-invoice via Storecove\/Peppol.", "operationId": "send_storecove_invoice", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "invoice_data": { "type": "object" } }, "required": [ "invoice_data" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_storecove_legal_entities": { "post": { "summary": "Get legal entities from Storecove.", "description": "Get legal entities from Storecove.", "operationId": "get_storecove_legal_entities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fiken_invoices": { "post": { "summary": "Get invoices from Fiken Norwegian accounting.", "description": "Get invoices from Fiken Norwegian accounting.", "operationId": "get_fiken_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fiken_contacts": { "post": { "summary": "Get contacts from Fiken.", "description": "Get contacts from Fiken.", "operationId": "get_fiken_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fiken_products": { "post": { "summary": "Get products from Fiken.", "description": "Get products from Fiken.", "operationId": "get_fiken_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_fiken_accounts": { "post": { "summary": "Get accounts from Fiken.", "description": "Get accounts from Fiken.", "operationId": "get_fiken_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dinero_invoices": { "post": { "summary": "Get invoices from Dinero Danish accounting.", "description": "Get invoices from Dinero Danish accounting.", "operationId": "get_dinero_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dinero_contacts": { "post": { "summary": "Get contacts from Dinero.", "description": "Get contacts from Dinero.", "operationId": "get_dinero_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dinero_products": { "post": { "summary": "Get products from Dinero.", "description": "Get products from Dinero.", "operationId": "get_dinero_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billy_invoices": { "post": { "summary": "Get invoices from Billy Danish accounting.", "description": "Get invoices from Billy Danish accounting.", "operationId": "get_billy_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billy_contacts": { "post": { "summary": "Get contacts from Billy.", "description": "Get contacts from Billy.", "operationId": "get_billy_contacts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billy_products": { "post": { "summary": "Get products from Billy.", "description": "Get products from Billy.", "operationId": "get_billy_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_billy_accounts": { "post": { "summary": "Get accounts from Billy.", "description": "Get accounts from Billy.", "operationId": "get_billy_accounts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_netvisor_invoices": { "post": { "summary": "Get invoices from Netvisor Finnish accounting.", "description": "Get invoices from Netvisor Finnish accounting.", "operationId": "get_netvisor_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_netvisor_customers": { "post": { "summary": "Get customers from Netvisor.", "description": "Get customers from Netvisor.", "operationId": "get_netvisor_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_netvisor_products": { "post": { "summary": "Get products from Netvisor.", "description": "Get products from Netvisor.", "operationId": "get_netvisor_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_directo_invoices": { "post": { "summary": "Get invoices from Directo Estonian ERP.", "description": "Get invoices from Directo Estonian ERP.", "operationId": "get_directo_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_directo_customers": { "post": { "summary": "Get customers from Directo.", "description": "Get customers from Directo.", "operationId": "get_directo_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_directo_articles": { "post": { "summary": "Get articles\/products from Directo.", "description": "Get articles\/products from Directo.", "operationId": "get_directo_articles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_finbite_invoices": { "post": { "summary": "Get e-invoices from Finbite.", "description": "Get e-invoices from Finbite.", "operationId": "get_finbite_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_finbite_documents": { "post": { "summary": "Get documents from Finbite.", "description": "Get documents from Finbite.", "operationId": "get_finbite_documents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/send_finbite_invoice": { "post": { "summary": "Send an e-invoice via Finbite.", "description": "Send an e-invoice via Finbite.", "operationId": "send_finbite_invoice", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "invoice_data": { "type": "object" } }, "required": [ "invoice_data" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_smartaccounts_invoices": { "post": { "summary": "Get invoices from SmartAccounts Estonian accounting.", "description": "Get invoices from SmartAccounts Estonian accounting.", "operationId": "get_smartaccounts_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_smartaccounts_clients": { "post": { "summary": "Get clients from SmartAccounts.", "description": "Get clients from SmartAccounts.", "operationId": "get_smartaccounts_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_smartaccounts_articles": { "post": { "summary": "Get articles from SmartAccounts.", "description": "Get articles from SmartAccounts.", "operationId": "get_smartaccounts_articles", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_rivile_invoices": { "post": { "summary": "Get invoices from Rivil\u0117 Lithuanian ERP.", "description": "Get invoices from Rivil\u0117 Lithuanian ERP.", "operationId": "get_rivile_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_rivile_clients": { "post": { "summary": "Get clients from Rivil\u0117.", "description": "Get clients from Rivil\u0117.", "operationId": "get_rivile_clients", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_rivile_products": { "post": { "summary": "Get products from Rivil\u0117.", "description": "Get products from Rivil\u0117.", "operationId": "get_rivile_products", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_kashflow_invoices": { "post": { "summary": "Get invoices from KashFlow UK accounting.", "description": "Get invoices from KashFlow UK accounting.", "operationId": "get_kashflow_invoices", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_kashflow_customers": { "post": { "summary": "Get customers from KashFlow.", "description": "Get customers from KashFlow.", "operationId": "get_kashflow_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_kashflow_receipts": { "post": { "summary": "Get receipts from KashFlow.", "description": "Get receipts from KashFlow.", "operationId": "get_kashflow_receipts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_mollie_payments": { "post": { "summary": "Get payments from Mollie payment platform.", "description": "Get payments from Mollie payment platform.", "operationId": "get_mollie_payments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_mollie_customers": { "post": { "summary": "Get customers from Mollie.", "description": "Get customers from Mollie.", "operationId": "get_mollie_customers", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_mollie_refunds": { "post": { "summary": "Get refunds from Mollie.", "description": "Get refunds from Mollie.", "operationId": "get_mollie_refunds", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_mollie_balances": { "post": { "summary": "Get balances from Mollie.", "description": "Get balances from Mollie.", "operationId": "get_mollie_balances", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sumup_transactions": { "post": { "summary": "Get transactions from SumUp POS.", "description": "Get transactions from SumUp POS.", "operationId": "get_sumup_transactions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sumup_profile": { "post": { "summary": "Get merchant profile from SumUp.", "description": "Get merchant profile from SumUp.", "operationId": "get_sumup_profile", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_sumup_payouts": { "post": { "summary": "Get payouts from SumUp.", "description": "Get payouts from SumUp.", "operationId": "get_sumup_payouts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hibob_employees": { "post": { "summary": "Get employees from HiBob HR platform.", "description": "Get employees from HiBob HR platform.", "operationId": "get_hibob_employees", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hibob_timeoff": { "post": { "summary": "Get time-off requests from HiBob.", "description": "Get time-off requests from HiBob.", "operationId": "get_hibob_timeoff", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hibob_attendance": { "post": { "summary": "Get attendance from HiBob.", "description": "Get attendance from HiBob.", "operationId": "get_hibob_attendance", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_hibob_reports": { "post": { "summary": "Get HR reports from HiBob.", "description": "Get HR reports from HiBob.", "operationId": "get_hibob_reports", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_remote_employees": { "post": { "summary": "Get employees from Remote.com HR.", "description": "Get employees from Remote.com HR.", "operationId": "get_remote_employees", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_remote_countries": { "post": { "summary": "Get supported countries from Remote.com.", "description": "Get supported countries from Remote.com.", "operationId": "get_remote_countries", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_remote_timeoff": { "post": { "summary": "Get time-off requests from Remote.com.", "description": "Get time-off requests from Remote.com.", "operationId": "get_remote_timeoff", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_oyster_people": { "post": { "summary": "Get people\/employees from Oyster HR.", "description": "Get people\/employees from Oyster HR.", "operationId": "get_oyster_people", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_oyster_departments": { "post": { "summary": "Get departments from Oyster HR.", "description": "Get departments from Oyster HR.", "operationId": "get_oyster_departments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_oyster_timeoff": { "post": { "summary": "Get time-off requests from Oyster HR.", "description": "Get time-off requests from Oyster HR.", "operationId": "get_oyster_timeoff", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "default": 20 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/analyze_schema": { "post": { "summary": "Perform a full Schema.org structured data audit on any webpage. Extracts all JSON-LD, Microdata, and RDFa markup, then evaluates rich snippet eligibility for Google (Article, Product, FAQ, LocalBusiness, etc.), identifies missing required fields, finds schema errors, and provides prioritized recommendations for improving search result appearance. Use when asked to \"check structured data\", \"audit schema markup\", or \"how can we get rich snippets in Google?\"", "description": "Perform a full Schema.org structured data audit on any webpage. Extracts all JSON-LD, Microdata, and RDFa markup, then evaluates rich snippet eligibility for Google (Article, Product, FAQ, LocalBusiness, etc.), identifies missing required fields, finds schema errors, and provides prioritized recommendations for improving search result appearance. Use when asked to \"check structured data\", \"audit schema markup\", or \"how can we get rich snippets in Google?\"", "operationId": "analyze_schema", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL of the page to analyze" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/check_schema_quick": { "post": { "summary": "Quick lightweight check of which Schema.org types exist on a page. Returns a simple list of found schema types (e.g. Organization, Article, Product) and counts by format (JSON-LD vs Microdata). Much faster than full analysis \u2014 use this first to check if any structured data exists before running a deep audit.", "description": "Quick lightweight check of which Schema.org types exist on a page. Returns a simple list of found schema types (e.g. Organization, Article, Product) and counts by format (JSON-LD vs Microdata). Much faster than full analysis \u2014 use this first to check if any structured data exists before running a deep audit.", "operationId": "check_schema_quick", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL of the page to check" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/validate_schema_type": { "post": { "summary": "Validate a specific Schema.org type (e.g. Product, Article, FAQPage, LocalBusiness) on a webpage. Checks if the schema exists, scores completeness by checking required and recommended fields, and provides a ready-to-use JSON-LD example if the schema is missing. Use when asked \"do we have Product schema?\" or \"is our FAQ markup correct?\" or \"add LocalBusiness schema.\"", "description": "Validate a specific Schema.org type (e.g. Product, Article, FAQPage, LocalBusiness) on a webpage. Checks if the schema exists, scores completeness by checking required and recommended fields, and provides a ready-to-use JSON-LD example if the schema is missing. Use when asked \"do we have Product schema?\" or \"is our FAQ markup correct?\" or \"add LocalBusiness schema.\"", "operationId": "validate_schema_type", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url", "schema_type" ], "properties": { "url": { "type": "string", "description": "URL of the page to validate" }, "schema_type": { "type": "string", "description": "Schema.org type to validate (e.g. Article, Product, FAQPage, LocalBusiness, Organization, BreadcrumbList, Event, Recipe, VideoObject, JobPosting, HowTo, Course)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/analyze_pagespeed": { "post": { "summary": "Analyze website loading performance via Google PageSpeed Insights API. Returns Lighthouse performance score (0-100), Core Web Vitals from real users (LCP, INP, CLS, FCP, TTFB), failed performance audits with estimated time\/size savings, and prioritized optimization recommendations. Choose mobile or desktop strategy. Use when asked \"how fast is our website?\", \"check page speed\", or \"why is our site slow?\"", "description": "Analyze website loading performance via Google PageSpeed Insights API. Returns Lighthouse performance score (0-100), Core Web Vitals from real users (LCP, INP, CLS, FCP, TTFB), failed performance audits with estimated time\/size savings, and prioritized optimization recommendations. Choose mobile or desktop strategy. Use when asked \"how fast is our website?\", \"check page speed\", or \"why is our site slow?\"", "operationId": "analyze_pagespeed", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL of the page to analyze" }, "strategy": { "type": "string", "enum": [ "mobile", "desktop" ], "default": "mobile", "description": "Device type for analysis" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/check_pagespeed_quick": { "post": { "summary": "Quick side-by-side performance score comparison for both mobile AND desktop in one call. Returns performance scores and Core Web Vitals (LCP, INP, CLS) for each device type, plus an overall assessment. Faster than running two separate analyses. Use when asked \"what are our speed scores?\" or \"compare mobile vs desktop performance.\" Results are cached for 5 minutes.", "description": "Quick side-by-side performance score comparison for both mobile AND desktop in one call. Returns performance scores and Core Web Vitals (LCP, INP, CLS) for each device type, plus an overall assessment. Faster than running two separate analyses. Use when asked \"what are our speed scores?\" or \"compare mobile vs desktop performance.\" Results are cached for 5 minutes.", "operationId": "check_pagespeed_quick", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL of the page to check" }, "strategy": { "type": "string", "enum": [ "mobile", "desktop" ], "description": "Ignored by this quick checker: it already checks both mobile and desktop. Use analyze_pagespeed for one strategy only." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/audit_pagespeed_full": { "post": { "summary": "Run a comprehensive Google Lighthouse audit covering all four categories: Performance (speed, Core Web Vitals), Accessibility (WCAG compliance, screen reader support), SEO (meta tags, crawlability, mobile-friendliness), and Best Practices (HTTPS, console errors, image formats). Returns scores for each category plus detailed failing audits with descriptions. Use for a complete website quality audit or when asked \"do a full site audit\" or \"check our accessibility.\"", "description": "Run a comprehensive Google Lighthouse audit covering all four categories: Performance (speed, Core Web Vitals), Accessibility (WCAG compliance, screen reader support), SEO (meta tags, crawlability, mobile-friendliness), and Best Practices (HTTPS, console errors, image formats). Returns scores for each category plus detailed failing audits with descriptions. Use for a complete website quality audit or when asked \"do a full site audit\" or \"check our accessibility.\"", "operationId": "audit_pagespeed_full", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL of the page to audit" }, "strategy": { "type": "string", "enum": [ "mobile", "desktop" ], "default": "mobile", "description": "Device type for audit" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/monthly_marketing_report": { "post": { "summary": "Generate a comprehensive monthly marketing report in a single call. Automatically gathers data from all connected marketing sources: GA4 website traffic and channel breakdown, Google Search Console top queries and top pages, social media metrics (Facebook, LinkedIn, Twitter \u2014 whichever are connected), and Google\/Meta ad campaign performance. Returns a structured report with sections for each data source, including which sources were available and which were not connected. Covers the specified month or defaults to last 30 days. Use when asked \"give me this month's marketing report\", \"how did we do last month?\", \"monthly overview\", or \"marketing summary.\"", "description": "Generate a comprehensive monthly marketing report in a single call. Automatically gathers data from all connected marketing sources: GA4 website traffic and channel breakdown, Google Search Console top queries and top pages, social media metrics (Facebook, LinkedIn, Twitter \u2014 whichever are connected), and Google\/Meta ad campaign performance. Returns a structured report with sections for each data source, including which sources were available and which were not connected. Covers the specified month or defaults to last 30 days. Use when asked \"give me this month's marketing report\", \"how did we do last month?\", \"monthly overview\", or \"marketing summary.\"", "operationId": "monthly_marketing_report", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "description": "Report start date (YYYY-MM-DD). Defaults to 30 days ago." }, "end_date": { "type": "string", "description": "Report end date (YYYY-MM-DD). Defaults to yesterday." }, "top_limit": { "type": "integer", "default": 10, "description": "Number of top queries\/pages to include (default: 10)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_social_engagement_chart": { "post": { "summary": "Chart-ready per-post engagement across Facebook and Instagram for a date range. Combines get_facebook_posts and get_instagram_posts, computes engagement per post (FB: reactions + comments + shares; IG: total interactions), sorts descending and returns {labels, datasets} for a chart_bar dashboard widget \u2014 one colored dataset per channel so FB and IG are visually distinct. Use as the source of a \"engagement per post\" dashboard widget; the dashboard date filter passes start_date\/end_date straight through.", "description": "Chart-ready per-post engagement across Facebook and Instagram for a date range. Combines get_facebook_posts and get_instagram_posts, computes engagement per post (FB: reactions + comments + shares; IG: total interactions), sorts descending and returns {labels, datasets} for a chart_bar dashboard widget \u2014 one colored dataset per channel so FB and IG are visually distinct. Use as the source of a \"engagement per post\" dashboard widget; the dashboard date filter passes start_date\/end_date straight through.", "operationId": "get_social_engagement_chart", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "description": "Start date (YYYY-MM-DD or daysAgo:N). Defaults to 28 days ago." }, "end_date": { "type": "string", "description": "End date (YYYY-MM-DD or today). Defaults to today." }, "limit": { "type": "integer", "default": 20, "description": "Max posts (bars) in the chart across both channels (default 20, max 40)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_track_parcel": { "post": { "summary": "Track a DPD parcel by tracking number. Returns tracking events with timestamps, statuses, and locations. Use when the user asks \"where is my package?\", \"track shipment\", or provides a DPD tracking number.", "description": "Track a DPD parcel by tracking number. Returns tracking events with timestamps, statuses, and locations. Use when the user asks \"where is my package?\", \"track shipment\", or provides a DPD tracking number.", "operationId": "dpd_track_parcel", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "tracking_number": { "type": "string", "description": "DPD parcel tracking number" } }, "required": [ "tracking_number" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_get_pickup_points": { "post": { "summary": "Get DPD Pickup parcel lockers and pickup points. Filter by city, postcode, or country. Returns locations with addresses, coordinates, and opening hours. Use for \"find nearest DPD pickup point\", \"DPD pakiautomaadid\", \"where can I pick up my package?\".", "description": "Get DPD Pickup parcel lockers and pickup points. Filter by city, postcode, or country. Returns locations with addresses, coordinates, and opening hours. Use for \"find nearest DPD pickup point\", \"DPD pakiautomaadid\", \"where can I pick up my package?\".", "operationId": "dpd_get_pickup_points", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "city": { "type": "string", "description": "Filter by city name (e.g., \"Tallinn\", \"Riga\", \"Vilnius\")" }, "postcode": { "type": "string", "description": "Filter by postal code" }, "country": { "type": "string", "enum": [ "EE", "LV", "LT" ], "description": "Country code. Defaults to connection country." }, "limit": { "type": "integer", "description": "Max number of pickup points to return. Default: 20" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_find_nearest_pickup": { "post": { "summary": "Find the nearest DPD pickup points by GPS coordinates. Returns pickup points sorted by distance. Use when user provides coordinates or wants the closest pickup location.", "description": "Find the nearest DPD pickup points by GPS coordinates. Returns pickup points sorted by distance. Use when user provides coordinates or wants the closest pickup location.", "operationId": "dpd_find_nearest_pickup", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "latitude": { "type": "number", "description": "GPS latitude" }, "longitude": { "type": "number", "description": "GPS longitude" }, "limit": { "type": "integer", "description": "Max results. Default: 5" } }, "required": [ "latitude", "longitude" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_create_shipment": { "post": { "summary": "Create a new DPD shipment \/ parcel. Generates tracking number and shipping label. Supports door delivery (D-B2C), pickup point delivery (PS), and COD (cash on delivery). Use for \"send a package\", \"create shipment\", \"ship order\".", "description": "Create a new DPD shipment \/ parcel. Generates tracking number and shipping label. Supports door delivery (D-B2C), pickup point delivery (PS), and COD (cash on delivery). Use for \"send a package\", \"create shipment\", \"ship order\".", "operationId": "dpd_create_shipment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "receiver_name": { "type": "string", "description": "Receiver full name or company" }, "receiver_street": { "type": "string", "description": "Receiver street address" }, "receiver_city": { "type": "string", "description": "Receiver city" }, "receiver_postcode": { "type": "string", "description": "Receiver postal code" }, "receiver_country": { "type": "string", "description": "Receiver country code (EE, LV, LT, etc.)" }, "receiver_phone": { "type": "string", "description": "Receiver phone number (for SMS notifications)" }, "receiver_email": { "type": "string", "description": "Receiver email (for delivery notifications)" }, "weight": { "type": "number", "description": "Parcel weight in kg. Default: 1" }, "parcel_count": { "type": "integer", "description": "Number of parcels. Default: 1" }, "order_number": { "type": "string", "description": "Your internal order reference number" }, "pickup_point_id": { "type": "string", "description": "DPD Pickup point ID for locker\/point delivery. If set, parcel_type is automatically PS." }, "cod_amount": { "type": "number", "description": "Cash on delivery amount. Leave empty for prepaid shipments." }, "remark": { "type": "string", "description": "Additional delivery notes\/remarks" } }, "required": [ "receiver_name", "receiver_street", "receiver_city", "receiver_postcode" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_get_label": { "post": { "summary": "Get shipping label PDF or ZPL for a DPD parcel. Returns printable label data. Use after creating a shipment to get the label for printing.", "description": "Get shipping label PDF or ZPL for a DPD parcel. Returns printable label data. Use after creating a shipment to get the label for printing.", "operationId": "dpd_get_label", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "parcel_number": { "type": "string", "description": "DPD parcel\/tracking number" }, "format": { "type": "string", "enum": [ "pdf", "zpl" ], "description": "Label format: pdf (default) or zpl (thermal printer)" } }, "required": [ "parcel_number" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_request_collection": { "post": { "summary": "Request a DPD courier pickup \/ collection from your address. Schedule when DPD courier should come to pick up parcels. Use for \"schedule pickup\", \"request courier\", \"kuller tuleb j\u00e4rgi\".", "description": "Request a DPD courier pickup \/ collection from your address. Schedule when DPD courier should come to pick up parcels. Use for \"schedule pickup\", \"request courier\", \"kuller tuleb j\u00e4rgi\".", "operationId": "dpd_request_collection", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "pickup_date": { "type": "string", "description": "Pickup date (YYYY-MM-DD)" }, "pickup_time_from": { "type": "string", "description": "Earliest pickup time (HH:MM). Default: 09:00" }, "pickup_time_to": { "type": "string", "description": "Latest pickup time (HH:MM). Default: 17:00" }, "sender_name": { "type": "string", "description": "Sender name \/ company" }, "sender_street": { "type": "string", "description": "Pickup address street" }, "sender_city": { "type": "string", "description": "Pickup address city" }, "sender_postcode": { "type": "string", "description": "Pickup address postal code" }, "sender_phone": { "type": "string", "description": "Contact phone for courier" }, "parcel_count": { "type": "integer", "description": "Number of parcels to pick up. Default: 1" }, "remark": { "type": "string", "description": "Notes for the courier" } }, "required": [ "pickup_date", "sender_name", "sender_street", "sender_city", "sender_postcode" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/dpd_close_day": { "post": { "summary": "Close\/manifest DPD shipments for the day. Finalizes all open shipments and generates manifest. Call at end of shipping day.", "description": "Close\/manifest DPD shipments for the day. Finalizes all open shipments and generates manifest. Call at end of shipping day.", "operationId": "dpd_close_day", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_track_shipment": { "post": { "summary": "Track a Venipak shipment by tracking number\/barcode. Returns tracking events with timestamps and statuses. Use for \"track Venipak package\", \"where is my Venipak shipment?\".", "description": "Track a Venipak shipment by tracking number\/barcode. Returns tracking events with timestamps and statuses. Use for \"track Venipak package\", \"where is my Venipak shipment?\".", "operationId": "venipak_track_shipment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "tracking_number": { "type": "string", "description": "Venipak shipment tracking number \/ barcode" } }, "required": [ "tracking_number" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_get_pickup_points": { "post": { "summary": "Get Venipak pickup points and parcel lockers. Filter by country and city. Returns locations with addresses, coordinates, and opening hours. Use for \"Venipak pakiautomaadid\", \"find Venipak pickup point\".", "description": "Get Venipak pickup points and parcel lockers. Filter by country and city. Returns locations with addresses, coordinates, and opening hours. Use for \"Venipak pakiautomaadid\", \"find Venipak pickup point\".", "operationId": "venipak_get_pickup_points", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "country": { "type": "string", "enum": [ "EE", "LV", "LT", "PL" ], "description": "Country code. Default: EE" }, "city": { "type": "string", "description": "Filter by city name" }, "limit": { "type": "integer", "description": "Max number of pickup points. Default: 20" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_find_nearest_pickup": { "post": { "summary": "Find nearest Venipak pickup points by GPS coordinates. Returns sorted by distance.", "description": "Find nearest Venipak pickup points by GPS coordinates. Returns sorted by distance.", "operationId": "venipak_find_nearest_pickup", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "latitude": { "type": "number", "description": "GPS latitude" }, "longitude": { "type": "number", "description": "GPS longitude" }, "country": { "type": "string", "enum": [ "EE", "LV", "LT", "PL" ], "description": "Country. Default: EE" }, "limit": { "type": "integer", "description": "Max results. Default: 5" } }, "required": [ "latitude", "longitude" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_create_shipment": { "post": { "summary": "Create a new Venipak shipment. Supports door delivery, pickup point delivery, and COD. Returns tracking number and label URL. Use for \"send package via Venipak\", \"create Venipak shipment\".", "description": "Create a new Venipak shipment. Supports door delivery, pickup point delivery, and COD. Returns tracking number and label URL. Use for \"send package via Venipak\", \"create Venipak shipment\".", "operationId": "venipak_create_shipment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "receiver_name": { "type": "string", "description": "Receiver name\/company" }, "receiver_street": { "type": "string", "description": "Receiver street address" }, "receiver_city": { "type": "string", "description": "Receiver city" }, "receiver_postcode": { "type": "string", "description": "Receiver postal code" }, "receiver_country": { "type": "string", "description": "Receiver country code (EE, LV, LT, PL)" }, "receiver_phone": { "type": "string", "description": "Receiver phone" }, "receiver_email": { "type": "string", "description": "Receiver email" }, "sender_name": { "type": "string", "description": "Sender name\/company" }, "sender_street": { "type": "string", "description": "Sender street" }, "sender_city": { "type": "string", "description": "Sender city" }, "sender_postcode": { "type": "string", "description": "Sender postal code" }, "sender_country": { "type": "string", "description": "Sender country code" }, "weight": { "type": "number", "description": "Weight in kg. Default: 1" }, "order_number": { "type": "string", "description": "Internal order reference" }, "pickup_point_id": { "type": "string", "description": "Venipak pickup point ID for locker delivery" }, "cod_amount": { "type": "number", "description": "Cash on delivery amount" }, "service": { "type": "string", "enum": [ "standard", "express", "pickup_point" ], "description": "Delivery service type" }, "remark": { "type": "string", "description": "Delivery notes" } }, "required": [ "receiver_name", "receiver_street", "receiver_city", "receiver_postcode" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_get_label": { "post": { "summary": "Get shipping label for a Venipak shipment. Returns PDF or ZPL label.", "description": "Get shipping label for a Venipak shipment. Returns PDF or ZPL label.", "operationId": "venipak_get_label", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "shipment_id": { "type": "string", "description": "Venipak shipment ID" }, "format": { "type": "string", "enum": [ "pdf", "zpl" ], "description": "Label format. Default: pdf" } }, "required": [ "shipment_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_request_collection": { "post": { "summary": "Request Venipak courier pickup from your address. Schedule when courier comes to pick up parcels.", "description": "Request Venipak courier pickup from your address. Schedule when courier comes to pick up parcels.", "operationId": "venipak_request_collection", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "pickup_date": { "type": "string", "description": "Pickup date (YYYY-MM-DD)" }, "pickup_time_from": { "type": "string", "description": "Earliest pickup (HH:MM). Default: 09:00" }, "pickup_time_to": { "type": "string", "description": "Latest pickup (HH:MM). Default: 17:00" }, "sender_name": { "type": "string", "description": "Sender name\/company" }, "sender_street": { "type": "string", "description": "Pickup street" }, "sender_city": { "type": "string", "description": "Pickup city" }, "sender_postcode": { "type": "string", "description": "Pickup postal code" }, "sender_country": { "type": "string", "description": "Country code" }, "sender_phone": { "type": "string", "description": "Contact phone" }, "parcel_count": { "type": "integer", "description": "Number of parcels. Default: 1" } }, "required": [ "pickup_date", "sender_name", "sender_street", "sender_city", "sender_postcode" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/venipak_create_manifest": { "post": { "summary": "Create manifest \/ close day for Venipak shipments. Finalizes shipments for courier handover.", "description": "Create manifest \/ close day for Venipak shipments. Finalizes shipments for courier handover.", "operationId": "venipak_create_manifest", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/lhv_get_balances": { "post": { "summary": "Get LHV Bank account balance (real-time). Shows current balance, available balance, and optionally payment limits. Use for \"mis mu konto saldo on?\", \"what is my balance?\", \"how much money do I have?\", \"palju kontol raha on?\".", "description": "Get LHV Bank account balance (real-time). Shows current balance, available balance, and optionally payment limits. Use for \"mis mu konto saldo on?\", \"what is my balance?\", \"how much money do I have?\", \"palju kontol raha on?\".", "operationId": "lhv_get_balances", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "iban": { "type": "string", "description": "Account IBAN (e.g. EE3877007710...). Uses stored IBAN if not provided." }, "include_payment_limits": { "type": "boolean", "description": "Include daily\/monthly payment limits. Default: false." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/lhv_get_transactions": { "post": { "summary": "Get LHV Bank account statement (transaction history). Shows all incoming\/outgoing payments with amounts, counterparties, references, dates. Use for \"show recent transactions\", \"n\u00e4ita tehinguid\", \"who paid me?\", \"payment history\", \"v\u00e4ljav\u00f5te\", \"makstud arved\".", "description": "Get LHV Bank account statement (transaction history). Shows all incoming\/outgoing payments with amounts, counterparties, references, dates. Use for \"show recent transactions\", \"n\u00e4ita tehinguid\", \"who paid me?\", \"payment history\", \"v\u00e4ljav\u00f5te\", \"makstud arved\".", "operationId": "lhv_get_transactions", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "iban": { "type": "string", "description": "Account IBAN. Uses stored IBAN if not provided." }, "date_from": { "type": "string", "description": "Start date (YYYY-MM-DD). Default: 30 days ago." }, "date_to": { "type": "string", "description": "End date (YYYY-MM-DD). Default: today." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/lhv_initiate_payment": { "post": { "summary": "Initiate a SEPA credit transfer via LHV Bank. Creates a payment order (pain.001). Use for \"make a payment\", \"send money\", \"tee \u00fclekanne\", \"pay invoice\", \"maksa arve\".", "description": "Initiate a SEPA credit transfer via LHV Bank. Creates a payment order (pain.001). Use for \"make a payment\", \"send money\", \"tee \u00fclekanne\", \"pay invoice\", \"maksa arve\".", "operationId": "lhv_initiate_payment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "amount": { "type": "number", "description": "Payment amount (e.g., 150.00)" }, "currency": { "type": "string", "description": "Currency code. Default: EUR" }, "debtor_iban": { "type": "string", "description": "Your (sender) IBAN. Uses stored IBAN if not provided." }, "creditor_iban": { "type": "string", "description": "Recipient IBAN" }, "creditor_name": { "type": "string", "description": "Recipient name" }, "reference": { "type": "string", "description": "Payment reference \/ description" }, "execution_date": { "type": "string", "description": "Execution date (YYYY-MM-DD). Default: today." } }, "required": [ "amount", "creditor_iban", "creditor_name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/lhv_get_messages": { "post": { "summary": "Check for pending LHV Bank messages (async responses). LHV Connect uses a message queue \u2014 after requesting a statement or balance, the response arrives as a message. Use to fetch results of previous requests.", "description": "Check for pending LHV Bank messages (async responses). LHV Connect uses a message queue \u2014 after requesting a statement or balance, the response arrives as a message. Use to fetch results of previous requests.", "operationId": "lhv_get_messages", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "count", "next", "confirm" ], "description": "\"count\" = how many pending, \"next\" = fetch oldest unread, \"confirm\" = mark as read. Default: next." }, "message_id": { "type": "string", "description": "Message ID to confirm (only for action=confirm)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_credit_status": { "post": { "summary": "Check current credit balance for this project. The monthly limit is only the recurring free allowance, not a hard usage cap. Purchased or admin-granted credits remain usable after the free allowance is exhausted. Returns total spendable credits and a status based on that total. Use this to check if the project has enough credits before performing multiple operations, or to inform the user about their credit status.", "description": "Check current credit balance for this project. The monthly limit is only the recurring free allowance, not a hard usage cap. Purchased or admin-granted credits remain usable after the free allowance is exhausted. Returns total spendable credits and a status based on that total. Use this to check if the project has enough credits before performing multiple operations, or to inform the user about their credit status.", "operationId": "get_credit_status", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_usage_summary": { "post": { "summary": "Get credit usage statistics: daily usage breakdown, top tools by usage count, and usage by bot type. Use to analyze spending patterns or report on API consumption.", "description": "Get credit usage statistics: daily usage breakdown, top tools by usage count, and usage by bot type. Use to analyze spending patterns or report on API consumption.", "operationId": "get_usage_summary", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "days": { "type": "integer", "description": "Number of days to look back (default: 30, max: 90)" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_purchase_url": { "post": { "summary": "Generate a Stripe payment URL where the user can buy more credits. Returns a direct checkout link that opens in a browser. Use when credits are low or exhausted, or when the user asks to buy\/purchase\/top-up credits. The URL is valid for a single purchase.", "description": "Generate a Stripe payment URL where the user can buy more credits. Returns a direct checkout link that opens in a browser. Use when credits are low or exhausted, or when the user asks to buy\/purchase\/top-up credits. The URL is valid for a single purchase.", "operationId": "get_purchase_url", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "package": { "type": "string", "enum": [ "starter", "business", "enterprise" ], "description": "Credit package: starter (1,000 credits \/ \u20ac20), business (3,000 \/ \u20ac50), enterprise (10,000 \/ \u20ac100). Default: starter." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_dashboard": { "post": { "summary": "Create a persistent dashboard page at https:\/\/sharksapi.ai\/{token}\/index.html with any combination of integration data widgets (GA4, GSC, Facebook, LinkedIn, etc.) and agent-authored text content (marketing plans, tasks, commentary). REQUIRED: You must ask the user for a dashboard password before calling this tool. The `password` field is mandatory; requests without it are rejected. The dashboard URL is publicly accessible \u2014 without a password, anyone with the link can view all data. Widgets fetch fresh data on view with hybrid caching (5 min GA4, 15 min GSC, 1h social). Time range filter is reactive. A \"Compare with previous period\" toggle shows delta % on metric cards and comparison lines on charts. When you include strategy_card widgets, a Command Center group header is auto-created at position 1. Do NOT create a separate Command Center text widget. Strategy card \"content\" field should contain the full audit\/strategy detail (shown via \"View strategy\" button). Completed cards (100%) auto-hide to History. Recipe \u2014 Brand mentions widget: { type: 'table', title: 'Social mentions', source: { tool: 'get_social_mentions', args: { query: '', days: 30 }, path: 'mentions' }, columns: ['platform','author','content','url','posted_at','sentiment'] }.", "description": "Create a persistent dashboard page at https:\/\/sharksapi.ai\/{token}\/index.html with any combination of integration data widgets (GA4, GSC, Facebook, LinkedIn, etc.) and agent-authored text content (marketing plans, tasks, commentary). REQUIRED: You must ask the user for a dashboard password before calling this tool. The `password` field is mandatory; requests without it are rejected. The dashboard URL is publicly accessible \u2014 without a password, anyone with the link can view all data. Widgets fetch fresh data on view with hybrid caching (5 min GA4, 15 min GSC, 1h social). Time range filter is reactive. A \"Compare with previous period\" toggle shows delta % on metric cards and comparison lines on charts. When you include strategy_card widgets, a Command Center group header is auto-created at position 1. Do NOT create a separate Command Center text widget. Strategy card \"content\" field should contain the full audit\/strategy detail (shown via \"View strategy\" button). Completed cards (100%) auto-hide to History. Recipe \u2014 Brand mentions widget: { type: 'table', title: 'Social mentions', source: { tool: 'get_social_mentions', args: { query: '', days: 30 }, path: 'mentions' }, columns: ['platform','author','content','url','posted_at','sentiment'] }.", "operationId": "create_dashboard", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name", "widgets", "password" ], "properties": { "name": { "type": "string", "description": "Display name for the dashboard (e.g. \"Weekly Marketing Overview\")" }, "description": { "type": "string", "description": "Optional description shown in the dashboard header" }, "default_date_range": { "type": "string", "enum": [ "last_7_days", "last_30_days", "last_90_days", "custom" ], "description": "Default date range when the dashboard loads. Use \"custom\" with default_start_date + default_end_date for absolute dates.", "default": "last_30_days" }, "default_start_date": { "type": "string", "format": "date", "description": "Optional ISO date (YYYY-MM-DD) for custom range default" }, "default_end_date": { "type": "string", "format": "date", "description": "Optional ISO date (YYYY-MM-DD) for custom range default" }, "is_public": { "type": "boolean", "description": "Whether the dashboard is accessible via its public URL. Defaults to true.", "default": true }, "expires_at": { "type": [ "string", "null" ], "format": "date-time", "description": "Optional ISO8601 timestamp. After this time the public URL returns 410 Gone. Null = never expires." }, "password": { "type": "string", "description": "REQUIRED \u2014 ask the user what password to set. The dashboard URL is public so a password gate is needed to protect business data. Viewers must enter this password before seeing the dashboard. Stored as a bcrypt hash. Do NOT skip this \u2014 always ask the user for a password." }, "role": { "type": "string", "enum": [ "agent", "manager" ], "description": "Dashboard role. \"agent\" (default) = a standalone dashboard for one agent \u2014 works completely on its own, no team needed. \"manager\" = a Turundusjuht Command Center that rolls up its team's agent sub-dashboards and holds the shared marketing plan. Most dashboards are \"agent\".", "default": "agent" }, "manager_token": { "type": "string", "description": "Optional. Public token of a manager dashboard (same project) to attach this agent dashboard under as a team member. When set, this dashboard appears in that manager's rollup and shows the shared marketing-plan context. Omit to create a standalone agent dashboard." }, "agent_key": { "type": "string", "description": "Optional. Stable slug identifying this agent within the team (e.g. \"seo\", \"google_ads\", \"copywriter\"). Must match the agent_keys used in the manager's marketing-plan pillars for the \"your pillar\" context to show. Recommended whenever manager_token is set." }, "agent_name": { "type": "string", "description": "Optional display name for this agent in the team rollup (defaults to the dashboard name)." }, "agent_icon": { "type": "string", "description": "Optional emoji\/short icon for this agent in the team rollup." }, "agent_accent": { "type": "string", "description": "Optional hex accent colour (e.g. \"#FF6B35\") for this agent in the team rollup." }, "widgets": { "type": "array", "description": "Array of widget objects. Each widget has {type, title, position, grid_cols, source OR content}. Use \"source\" for integration tool widgets (e.g. get_ga4) and \"content\" for agent-authored text blocks.", "items": { "type": "object", "required": [ "type", "position" ], "properties": { "type": { "type": "string", "enum": [ "metric_card", "chart_line", "chart_bar", "table", "text_markdown", "strategy_card", "competitor_watch" ], "description": "Widget renderer: metric_card (single number), chart_line (time series), chart_bar, table, text_markdown (agent content), strategy_card (interactive task checklist with expandable strategy\/audit detail \u2014 put the full audit text in \"content\" so it appears when the user clicks \"View strategy\"), competitor_watch (cross-channel competitor comparison table \u2014 pass the competitor JSON object as \"content\")" }, "title": { "type": "string" }, "position": { "type": "integer", "description": "0-based order on the dashboard" }, "grid_cols": { "type": "integer", "minimum": 1, "maximum": 12, "description": "Width in 12-column grid units. Typical: metric_card=3, chart=6-9, text_markdown=12", "default": 4 }, "source": { "type": "object", "description": "For integration_tool widgets: {tool: \"get_ga4\", arguments: {...}}. The tool is called at view time with the user's date range filter merged into arguments. IMPORTANT for metric_card widgets: always include metric in arguments so the card shows the right value \u2014 e.g. {tool: \"get_ga4\", arguments: {metric: \"sessions\"}} or {tool: \"get_search_console\", arguments: {metric: \"clicks\"}}. Without metric, all cards will show the same first numeric field.", "properties": { "tool": { "type": "string" }, "arguments": { "type": "object" } } }, "content": { "type": "string", "description": "For text_markdown widgets: raw markdown content. For strategy_card widgets: the full audit\/strategy detail text shown when user clicks \"View strategy\" (put the audit findings HERE, not as a separate text_markdown widget). Never cached \u2014 stored as-is." }, "cache_ttl_seconds": { "type": "integer", "description": "Override the default cache TTL for integration tool widgets. Defaults: GA4=300, GSC=900, social=3600." } } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dashboard": { "post": { "summary": "Fetch a dashboard's configuration by its public token. Returns the dashboard metadata, widget list, and public URL \u2014 but not the live data (data is fetched on view). Use this to inspect what you previously built.", "description": "Fetch a dashboard's configuration by its public token. Returns the dashboard metadata, widget list, and public URL \u2014 but not the live data (data is fetched on view). Use this to inspect what you previously built.", "operationId": "get_dashboard", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "The public_token returned when the dashboard was created" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_dashboard_access_link": { "post": { "summary": "Get a short-lived signed URL that opens a password-protected dashboard of THIS project in a browser WITHOUT typing the password \u2014 for a browser session the agent drives itself (screen recording for a demo video, visual QA, a live walkthrough). Opening the URL sets the same unlock cookie a human gets after the password form (valid 24h; a manager unlock also opens its agent dashboards) and redirects to \/{token}\/index.html \u2014 keep the same browser context for the whole session. The link expires after ttl_minutes (default 15, max 60), works only for dashboards in your project and leaves the password in place. Treat it like the password: never paste it into posts, memory, tickets or a recording. To READ dashboard data use read_dashboard instead \u2014 this tool is only for when the real rendered page is needed.", "description": "Get a short-lived signed URL that opens a password-protected dashboard of THIS project in a browser WITHOUT typing the password \u2014 for a browser session the agent drives itself (screen recording for a demo video, visual QA, a live walkthrough). Opening the URL sets the same unlock cookie a human gets after the password form (valid 24h; a manager unlock also opens its agent dashboards) and redirects to \/{token}\/index.html \u2014 keep the same browser context for the whole session. The link expires after ttl_minutes (default 15, max 60), works only for dashboards in your project and leaves the password in place. Treat it like the password: never paste it into posts, memory, tickets or a recording. To READ dashboard data use read_dashboard instead \u2014 this tool is only for when the real rendered page is needed.", "operationId": "get_dashboard_access_link", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token (agent or manager dashboard, same project as your auth)." }, "ttl_minutes": { "type": "integer", "default": 15, "description": "How long the link itself stays openable (1\u201360). The unlock it grants lasts 24h regardless." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/read_dashboard": { "post": { "summary": "Read a FULL dashboard \u2014 layout AND live widget data \u2014 in one call. Use this instead of opening the public URL in a browser: it returns every widget's current values (metric cards, chart series, tables, markdown, strategy cards with task ids\/status), the shared marketing-plan context for team agents, and the manager rollup when the token is a manager dashboard. Integration widgets are fetched server-side with the same caching as the public page. Returns compact JSON ordered by widget position. Combine with update_strategy_task \/ delegate_to_agents to act on what you read \u2014 no browser needed.", "description": "Read a FULL dashboard \u2014 layout AND live widget data \u2014 in one call. Use this instead of opening the public URL in a browser: it returns every widget's current values (metric cards, chart series, tables, markdown, strategy cards with task ids\/status), the shared marketing-plan context for team agents, and the manager rollup when the token is a manager dashboard. Integration widgets are fetched server-side with the same caching as the public page. Returns compact JSON ordered by widget position. Combine with update_strategy_task \/ delegate_to_agents to act on what you read \u2014 no browser needed.", "operationId": "read_dashboard", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token (agent or manager dashboard, same project as your auth)." }, "start_date": { "type": "string", "format": "date", "description": "Optional YYYY-MM-DD; defaults to the dashboard's default range (usually last 30 days)." }, "end_date": { "type": "string", "format": "date" }, "include_data": { "type": "boolean", "default": true, "description": "false = layout\/status only (faster), true = fetch live data for every widget." }, "max_table_rows": { "type": "integer", "default": 25, "description": "Cap rows returned per table\/chart widget to keep the payload small (max 100)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_dashboard": { "post": { "summary": "Partially update an existing dashboard by token. Supports changing name\/description\/dates\/password, adding new widgets, removing widgets by position, and updating existing widget content (e.g. refresh a marketing plan).", "description": "Partially update an existing dashboard by token. Supports changing name\/description\/dates\/password, adding new widgets, removing widgets by position, and updating existing widget content (e.g. refresh a marketing plan).", "operationId": "update_dashboard", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "default_date_range": { "type": "string" }, "default_start_date": { "type": "string", "format": "date" }, "default_end_date": { "type": "string", "format": "date" }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" }, "password": { "type": [ "string", "null" ], "description": "Set a new viewer password (plaintext, will be bcrypt-hashed). Pass null to remove protection. Omit this field to leave the existing password unchanged." }, "add_widgets": { "type": "array", "description": "New widgets to append. Same shape as widgets in create_dashboard." }, "remove_widget_positions": { "type": "array", "items": { "type": "integer" }, "description": "Position numbers of widgets to delete" }, "update_widgets": { "type": "array", "description": "Widgets to mutate by position \u2014 e.g. [{\"position\": 2, \"content\": \"## New plan\"}]. For strategy_card widgets, pass {\"source\":{\"mode\":\"human_controlled\"}} or {\"source\":{\"mode\":\"ai_controlled\"}} to change card mode without replacing tasks." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/delete_dashboard": { "post": { "summary": "Permanently delete a dashboard by its public token. This also deletes all widgets and cached data. Only agents from the owning project can delete.", "description": "Permanently delete a dashboard by its public token. This also deletes all widgets and cached data. Only agents from the owning project can delete.", "operationId": "delete_dashboard", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_strategy_task": { "post": { "summary": "Toggle a task on a strategy card \u2014 mark as completed or pending. Use this when the AI agent has finished executing a task (e.g. updated a meta description, submitted a re-index request). Agents may update any strategy task they can access, including human-controlled tasks; completed tasks are recorded with completed_by=ai. Use get_strategy_status to see each task's task_mode\/effective_mode for coordination. Returns the updated task state. Optionally set note (free text) and label (one of: blocked, needs_human, needs_access, in_progress) to annotate task state. Identify the task by task_id (DB id) OR task_number (1-indexed order from get_strategy_status). task_id takes precedence if both are supplied.", "description": "Toggle a task on a strategy card \u2014 mark as completed or pending. Use this when the AI agent has finished executing a task (e.g. updated a meta description, submitted a re-index request). Agents may update any strategy task they can access, including human-controlled tasks; completed tasks are recorded with completed_by=ai. Use get_strategy_status to see each task's task_mode\/effective_mode for coordination. Returns the updated task state. Optionally set note (free text) and label (one of: blocked, needs_human, needs_access, in_progress) to annotate task state. Identify the task by task_id (DB id) OR task_number (1-indexed order from get_strategy_status). task_id takes precedence if both are supplied.", "operationId": "update_strategy_task", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token", "widget_id" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token" }, "widget_id": { "type": "integer", "description": "Strategy card widget ID" }, "task_id": { "type": "integer", "description": "Task ID within the strategy card. Either task_id or task_number is required. task_id takes precedence if both are supplied." }, "task_number": { "type": "integer", "description": "Alternative to task_id: 1-indexed order of the task within the strategy card (as shown in get_strategy_status output and on the public dashboard, e.g. \"#2\" = task_number 2). Either task_id or task_number is required." }, "is_completed": { "type": "boolean", "description": "true to mark done, false to reopen. Omit to leave completion state unchanged (note\/label-only update)." }, "is_skipped": { "type": "boolean", "description": "Read-only compatibility field from get_strategy_status. false is ignored; true is rejected because only a human can deactivate\/skip a task from the dashboard UI." }, "completed_by": { "type": [ "string", "null" ], "description": "Read-only compatibility field from get_strategy_status. Ignored on write; completed tasks are recorded as completed_by=ai by the platform." }, "completed_at": { "type": [ "string", "null" ], "description": "Read-only compatibility field from get_strategy_status. Ignored on write; timestamps are set by the platform." }, "note": { "type": [ "string", "null" ], "description": "Optional free-text note explaining task state (e.g. why blocked, what is missing). Pass null or omit to leave unchanged." }, "label": { "type": [ "string", "null" ], "enum": [ null, "blocked", "needs_human", "needs_access", "in_progress" ], "description": "Optional state label. in_progress = you are on it. blocked = something stops you (note required: what). needs_human \/ needs_access put the task on the manager's \"Postkast\" queue (\/inbox) \u2014 note (start with VAJA: \u2026) AND human_reason are required, and the label is refused when a platform tool already covers the ask (WordPress pages\/redirects\/seo\/schema, submit_social_post, send_email): call the tool instead. Pass null to clear." }, "human_reason": { "type": [ "string", "null" ], "enum": [ null, "decision", "access", "no_api", "manual_ui" ], "description": "Required with needs_human \/ needs_access. decision = manager must decide (budget, go\/no-go). access = credential, OAuth click or permission you lack. no_api = the platform has no tool for this action. manual_ui = must be done by hand in a third-party UI (Google Ads, GTM, hosting panel, ssh)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_strategy_status": { "post": { "summary": "Get the current status of a strategy card \u2014 title, mode, and all tasks with their completion state. Use this before creating a new strategy to see what was done previously, or to monitor progress of an AI-controlled strategy. Each task has an `is_skipped` flag and an `actionable` flag: tasks with is_skipped=true were deactivated by a human and MUST NOT be executed or completed by an agent \u2014 skip them. progress_pct counts skipped tasks as resolved (alongside completed).", "description": "Get the current status of a strategy card \u2014 title, mode, and all tasks with their completion state. Use this before creating a new strategy to see what was done previously, or to monitor progress of an AI-controlled strategy. Each task has an `is_skipped` flag and an `actionable` flag: tasks with is_skipped=true were deactivated by a human and MUST NOT be executed or completed by an agent \u2014 skip them. progress_pct counts skipped tasks as resolved (alongside completed).", "operationId": "get_strategy_status", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token" }, "widget_id": { "type": "integer", "description": "Strategy card widget ID. Optional when the dashboard has exactly one strategy card; otherwise the error returns the available card ids." }, "task_id": { "type": "integer", "description": "Optional compatibility lookup: when you only know a task id, the platform infers the owning strategy card and returns that card status." }, "task_ids": { "type": "array", "items": { "type": "integer" }, "description": "Optional compatibility lookup for copied task lists. The first valid task id is used to infer the strategy card." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/delete_strategy_task": { "post": { "summary": "Delete a task from a strategy card. Identify the task by task_id (DB id) OR task_number (1-indexed order from get_strategy_status). task_id takes precedence if both are supplied. Use when a task is no longer relevant (e.g. the underlying condition changed) or was created in error. Does NOT enforce task_mode \u2014 any agent with access to the dashboard project can delete.", "description": "Delete a task from a strategy card. Identify the task by task_id (DB id) OR task_number (1-indexed order from get_strategy_status). task_id takes precedence if both are supplied. Use when a task is no longer relevant (e.g. the underlying condition changed) or was created in error. Does NOT enforce task_mode \u2014 any agent with access to the dashboard project can delete.", "operationId": "delete_strategy_task", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token", "widget_id" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token" }, "widget_id": { "type": "integer", "description": "Strategy card widget ID" }, "task_id": { "type": "integer", "description": "Task ID within the strategy card. Either task_id or task_number is required. task_id wins if both supplied." }, "task_number": { "type": "integer", "description": "Alternative to task_id: 1-indexed order of the task within the strategy card (as shown in get_strategy_status output)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/invalidate_dashboard_cache": { "post": { "summary": "Clear all cached widget data for a dashboard, forcing the next view to refetch live data. Use when you know the underlying integration data just changed and want viewers to see the latest values immediately.", "description": "Clear all cached widget data for a dashboard, forcing the next view to refetch live data. Use when you know the underlying integration data just changed and want viewers to see the latest values immediately.", "operationId": "invalidate_dashboard_cache", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/add_strategy_card": { "post": { "summary": "A subagent (SEO, Google Ads, Copywriter, Meta Ads, Analyst, Event, etc.) creates ONE of its own strategy cards \u2014 a strategy plus its own to-do list \u2014 on its dashboard. The card automatically rolls up to the parent Turundusjuht (manager) Command Center: its progress, severity and pillar feed the manager's Top-5 and plan coverage with no extra step. Set \"pillar\" to tie the work to a marketing-plan pillar (e.g. organic, paid, conversion, brand) so it counts toward that pillar's coverage. Set \"severity\" so it can surface in the manager Top-5. This is the primary tool for agents to self-organise their work. No 5-card limit (unlike create_dashboard).", "description": "A subagent (SEO, Google Ads, Copywriter, Meta Ads, Analyst, Event, etc.) creates ONE of its own strategy cards \u2014 a strategy plus its own to-do list \u2014 on its dashboard. The card automatically rolls up to the parent Turundusjuht (manager) Command Center: its progress, severity and pillar feed the manager's Top-5 and plan coverage with no extra step. Set \"pillar\" to tie the work to a marketing-plan pillar (e.g. organic, paid, conversion, brand) so it counts toward that pillar's coverage. Set \"severity\" so it can surface in the manager Top-5. This is the primary tool for agents to self-organise their work. No 5-card limit (unlike create_dashboard).", "operationId": "add_strategy_card", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token", "title" ], "properties": { "token": { "type": "string", "description": "public_token of the agent's OWN dashboard (a sub-dashboard under a manager). Get it from get_team_overview agents[].child_token, or the token you created." }, "title": { "type": "string", "description": "Strategy \/ card title, e.g. \"Tehniline SEO audit\"." }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low" ], "description": "How critical this strategy is. Drives the manager Top-5 ranking. Omit if not pressing." }, "pillar": { "type": "string", "description": "Marketing-plan pillar key this work ladders up to (e.g. organic, paid, conversion, brand). Makes the card count toward that pillar's coverage on the manager dashboard." }, "strategy": { "type": "string", "description": "Optional markdown describing the strategy \/ audit \/ rationale (shown in the card's \"View strategy\" detail)." }, "mode": { "type": "string", "enum": [ "human_controlled", "ai_controlled" ], "description": "Who works the to-dos. Default ai_controlled (the agent executes and marks them done)." }, "tasks": { "type": "array", "description": "The to-do list for this strategy.", "items": { "type": [ "object", "string" ], "required": [ "title" ], "properties": { "title": { "type": "string" }, "text": { "type": "string", "description": "Alias for title; accepted for agents that describe tasks as text." }, "description": { "type": "string" }, "label": { "type": "string", "enum": [ "blocked", "needs_human", "needs_access", "in_progress" ], "description": "Optional status signal. blocked \/ needs_access \/ needs_human require a note (VAJA: \u2026); needs_human \/ needs_access also require human_reason and are refused when a platform tool covers the ask." }, "note": { "type": "string", "description": "Required with blocked \/ needs_human \/ needs_access: the one-line ask for the human, starting VAJA: \u2026" }, "human_reason": { "type": "string", "enum": [ "decision", "access", "no_api", "manual_ui" ] }, "done": { "type": "boolean", "description": "Mark already-completed at creation." } } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/add_strategy_tasks": { "post": { "summary": "Append more to-do items to an existing strategy card (grow the to-do list). Use after add_strategy_card when new work emerges. New tasks are appended after existing ones. Changes roll up to the manager automatically.", "description": "Append more to-do items to an existing strategy card (grow the to-do list). Use after add_strategy_card when new work emerges. New tasks are appended after existing ones. Changes roll up to the manager automatically.", "operationId": "add_strategy_tasks", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token", "widget_id", "tasks" ], "properties": { "token": { "type": "string", "description": "Dashboard public_token the strategy card lives on." }, "widget_id": { "type": "integer", "description": "Strategy card widget ID (from add_strategy_card or get_strategy_status)." }, "tasks": { "type": "array", "items": { "type": [ "object", "string" ], "required": [ "title" ], "properties": { "title": { "type": "string" }, "text": { "type": "string", "description": "Alias for title; accepted for agents that describe tasks as text." }, "description": { "type": "string" }, "label": { "type": "string", "enum": [ "blocked", "needs_human", "needs_access", "in_progress" ], "description": "blocked \/ needs_access \/ needs_human require a note; needs_human \/ needs_access also require human_reason and are refused when a platform tool covers the ask." }, "note": { "type": "string", "description": "Required with blocked \/ needs_human \/ needs_access: the one-line ask, starting VAJA: \u2026" }, "human_reason": { "type": "string", "enum": [ "decision", "access", "no_api", "manual_ui" ] } } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_team_capabilities": { "post": { "summary": "Orientation for planning: what marketing-agent roles you can use on THIS project, what each does, which SharksAPI data sources are LIVE (connected) vs missing, and the recommended skills per role. Works even before any dashboard\/team exists \u2014 call it FIRST when turning a planning brief into an annual plan, then set_marketing_plan + create_dashboard + delegate_to_agents + add_plan_activity to distribute the work. Returns whether a manager dashboard already exists. Measure only anonymous data \u2014 never applicant PII.", "description": "Orientation for planning: what marketing-agent roles you can use on THIS project, what each does, which SharksAPI data sources are LIVE (connected) vs missing, and the recommended skills per role. Works even before any dashboard\/team exists \u2014 call it FIRST when turning a planning brief into an annual plan, then set_marketing_plan + create_dashboard + delegate_to_agents + add_plan_activity to distribute the work. Returns whether a manager dashboard already exists. Measure only anonymous data \u2014 never applicant PII.", "operationId": "get_team_capabilities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_team_overview": { "post": { "summary": "Read the rolled-up state of a Turundusjuht (manager) Command Center: every subagent's status (ok\/attention\/critical) and progress, the Top-5 most pressing topics across the team, and marketing-plan pillar coverage. Pass the MANAGER dashboard token. The returned agents[] include each subagent's child_token \u2014 use those tokens with add_strategy_card so each agent fills its own area. This is how the manager agent sees the whole team on one dash.", "description": "Read the rolled-up state of a Turundusjuht (manager) Command Center: every subagent's status (ok\/attention\/critical) and progress, the Top-5 most pressing topics across the team, and marketing-plan pillar coverage. Pass the MANAGER dashboard token. The returned agents[] include each subagent's child_token \u2014 use those tokens with add_strategy_card so each agent fills its own area. This is how the manager agent sees the whole team on one dash.", "operationId": "get_team_overview", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Manager dashboard public_token (the one whose layout_config.dashboard_role = manager)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/set_marketing_plan": { "post": { "summary": "Create or update the shared marketing plan on a MANAGER dashboard \u2014 the team's common foundation. Holds the north-star goal, KPIs and strategic pillars. Each pillar lists agent_keys that map the plan to specific teammates; an agent sub-dashboard whose agent_key matches a pillar shows that pillar as \"your pillar\". Call this once after creating the manager dashboard, and again to revise. Re-calling replaces the active plan for that manager.", "description": "Create or update the shared marketing plan on a MANAGER dashboard \u2014 the team's common foundation. Holds the north-star goal, KPIs and strategic pillars. Each pillar lists agent_keys that map the plan to specific teammates; an agent sub-dashboard whose agent_key matches a pillar shows that pillar as \"your pillar\". Call this once after creating the manager dashboard, and again to revise. Re-calling replaces the active plan for that manager.", "operationId": "set_marketing_plan", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "manager_token", "north_star" ], "properties": { "manager_token": { "type": "string", "description": "Public token of the manager dashboard this plan governs." }, "name": { "type": "string", "description": "Plan name (e.g. \"Q3 2026 Turundusplaan\")." }, "north_star": { "type": "string", "description": "The single overarching goal for the period." }, "period": { "type": "string", "description": "Optional period label (e.g. \"Q3 2026\")." }, "audience": { "type": "string", "description": "Optional target audience." }, "budget": { "type": "string", "description": "Optional budget label (e.g. \"\u20ac8000 \/ kuus\")." }, "kpis": { "type": "array", "description": "KPI objects: {name, current, target, unit, direction:\"up\"|\"down\"}. direction \"down\" = lower is better.", "items": { "type": "object" } }, "pillars": { "type": "array", "description": "Strategic pillars: {name, objective, accent (hex), agent_keys:[...]}. agent_keys link the pillar to teammates by their agent_key.", "items": { "type": "object" } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/link_to_manager": { "post": { "summary": "Attach an existing standalone agent dashboard under a manager dashboard as a team member (or detach it). Use this when an agent built its own dashboard first and now joins a team. Both dashboards must be in the same project. Sets parent + agent_key so the dashboard appears in the manager rollup and shows the shared plan context.", "description": "Attach an existing standalone agent dashboard under a manager dashboard as a team member (or detach it). Use this when an agent built its own dashboard first and now joins a team. Both dashboards must be in the same project. Sets parent + agent_key so the dashboard appears in the manager rollup and shows the shared plan context.", "operationId": "link_to_manager", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Public token of the agent dashboard to link." }, "manager_token": { "type": [ "string", "null" ], "description": "Public token of the manager dashboard to attach under. Pass null to DETACH and make this a standalone dashboard again." }, "agent_key": { "type": "string", "description": "Stable slug for this agent in the team (e.g. \"seo\"). Should match a manager plan pillar's agent_keys." }, "agent_name": { "type": "string" }, "agent_icon": { "type": "string" }, "agent_accent": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/delegate_to_agents": { "post": { "summary": "TOP-DOWN delegation: the Turundusjuht (manager) pushes work to one or MORE teammate agents in a single call. Each assignment becomes a strategy card on that agent's own Command Center, stamped \"Turundusjuhilt\" (assigned_by=manager) so the agent knows it came from the boss \u2014 and it rolls back up to the manager's rollup automatically. Use when the user gives the manager a campaign\/initiative that needs specific agents to act (e.g. new campaign \u2192 paid ads agent + copywriter agent). The manager decides ordering: use depends_on (which agent_keys must deliver first) and conditions (free-text extra requirements, e.g. \"k\u00e4ivita alles p\u00e4rast tekstide valmimist; eelarve \u20ac500\"). Dependencies are informational discipline for the agents \u2014 the manager is the orchestrator.", "description": "TOP-DOWN delegation: the Turundusjuht (manager) pushes work to one or MORE teammate agents in a single call. Each assignment becomes a strategy card on that agent's own Command Center, stamped \"Turundusjuhilt\" (assigned_by=manager) so the agent knows it came from the boss \u2014 and it rolls back up to the manager's rollup automatically. Use when the user gives the manager a campaign\/initiative that needs specific agents to act (e.g. new campaign \u2192 paid ads agent + copywriter agent). The manager decides ordering: use depends_on (which agent_keys must deliver first) and conditions (free-text extra requirements, e.g. \"k\u00e4ivita alles p\u00e4rast tekstide valmimist; eelarve \u20ac500\"). Dependencies are informational discipline for the agents \u2014 the manager is the orchestrator.", "operationId": "delegate_to_agents", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "manager_token", "assignments" ], "properties": { "manager_token": { "type": "string", "description": "Public token of the manager (Turundusjuht) dashboard doing the delegating." }, "assignments": { "type": "array", "description": "One entry per target agent. Each becomes a strategy card on that agent's dashboard.", "items": { "type": "object", "required": [ "agent_key", "title" ], "properties": { "agent_key": { "type": "string", "description": "Teammate agent key (e.g. \"paid\", \"copy\", \"seo\") \u2014 must match a child dashboard's agent key under this manager." }, "title": { "type": "string", "description": "Card title, e.g. \"Uue kampaania k\u00e4ivitamine \u2014 xxx leht\"." }, "tasks": { "type": "array", "description": "Subtasks for this agent. Items: {title, description?, label?} \u2014 or plain strings (a string becomes the task title).", "items": { "type": [ "object", "string" ] } }, "pillar": { "type": "string", "description": "Marketing-plan pillar key (defaults to the pillar that owns this agent)." }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low" ] }, "strategy": { "type": "string", "description": "Markdown brief\/rationale shown under \"View strategy\"." }, "mode": { "type": "string", "enum": [ "human_controlled", "ai_controlled" ], "description": "Default ai_controlled." }, "depends_on": { "type": "array", "items": { "type": "string" }, "description": "agent_keys whose deliverables must come FIRST (e.g. paid depends_on [\"copy\"]). Shown on the card so the agent waits." }, "conditions": { "type": "string", "description": "Manager's extra conditions\/constraints in free text (budget, timing, approvals). Shown on the card." } } } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/manage_strategy_card": { "post": { "summary": "Manager control over a teammate's strategy card (the items behind the Turundusjuht Top-5). The Top-5 is a live rollup \u2014 you don't edit it directly, you act on the underlying card and the Top-5 updates automatically. Identify the card by its dashboard token + widget_id (both come from get_team_overview: top_issues[].child_token + top_issues[].widget_id, or agents[].child_token). Actions: \"close\" (finish the card: it moves to the Command Center \"Tehtud\" stack and keeps its tasks \u2014 use this for last week's card when a new weekly card starts), \"reopen\", \"delete\" (remove the card entirely \u2014 refused when it has completed tasks unless force=true), \"pause\"\/\"resume\" (a paused card drops out of the Top-5 and critical counts until resumed), \"set_severity\" (re-prioritise in the Top-5), \"reassign\" (move the whole card \u2014 title, strategy, tasks and their done-state \u2014 to another teammate agent, stamped Turundusjuhilt), \"update_strategy\" (replace the markdown shown in View strategy).", "description": "Manager control over a teammate's strategy card (the items behind the Turundusjuht Top-5). The Top-5 is a live rollup \u2014 you don't edit it directly, you act on the underlying card and the Top-5 updates automatically. Identify the card by its dashboard token + widget_id (both come from get_team_overview: top_issues[].child_token + top_issues[].widget_id, or agents[].child_token). Actions: \"close\" (finish the card: it moves to the Command Center \"Tehtud\" stack and keeps its tasks \u2014 use this for last week's card when a new weekly card starts), \"reopen\", \"delete\" (remove the card entirely \u2014 refused when it has completed tasks unless force=true), \"pause\"\/\"resume\" (a paused card drops out of the Top-5 and critical counts until resumed), \"set_severity\" (re-prioritise in the Top-5), \"reassign\" (move the whole card \u2014 title, strategy, tasks and their done-state \u2014 to another teammate agent, stamped Turundusjuhilt), \"update_strategy\" (replace the markdown shown in View strategy).", "operationId": "manage_strategy_card", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "token", "widget_id", "action" ], "properties": { "token": { "type": "string", "description": "public_token of the dashboard the card lives on (the agent's dashboard \u2014 top_issues[].child_token)." }, "widget_id": { "type": "integer", "description": "Strategy card widget id (top_issues[].widget_id)." }, "action": { "type": "string", "enum": [ "close", "reopen", "delete", "pause", "resume", "set_severity", "reassign", "update_strategy" ], "description": "What to do with the card. Weekly routine: when you start a new week's card, \"close\" the previous one (it moves to the Tehtud stack with its history) \u2014 never \"delete\" it. \"delete\" is refused for cards with completed tasks unless force=true." }, "force": { "type": "boolean", "default": false, "description": "Only with action=delete: delete even though the card has completed tasks. Requires an explicit user instruction." }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low" ], "description": "Required for action=set_severity." }, "to_agent_key": { "type": "string", "description": "Required for action=reassign \u2014 the teammate agent key to move the card to (e.g. \"copy\", \"paid\"). Must be another agent under the same manager." }, "strategy": { "type": "string", "description": "Required for action=update_strategy \u2014 replacement markdown for the card detail." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/invite_teammate": { "post": { "summary": "Share full access to THIS project with another person's Claude Cowork \u2014 fully A2A, no web page. Creates a team invite and returns an invite_token + a ready recipient_instruction. The recipient's OWN agent accepts by POSTing {invite_token, name} to \/api\/v1\/a2a\/accept-invite, which provisions a claude_cowork agent scoped to the SAME project and returns its client_id + client_secret + mcp_url. They can then command the same team \u2014 Turundusjuht, SEO agent, etc. (delegate_to_agents, read_dashboard, set_marketing_plan, all of it). ALSO does credential recovery: if the email already belongs to a teammate who lost their secret, accepting REFRESHES it (client_id + connections stay; response sets recovery:true). Pass the recipient_instruction (or invite_token) to the colleague. A web fallback (invite_url) also exists.", "description": "Share full access to THIS project with another person's Claude Cowork \u2014 fully A2A, no web page. Creates a team invite and returns an invite_token + a ready recipient_instruction. The recipient's OWN agent accepts by POSTing {invite_token, name} to \/api\/v1\/a2a\/accept-invite, which provisions a claude_cowork agent scoped to the SAME project and returns its client_id + client_secret + mcp_url. They can then command the same team \u2014 Turundusjuht, SEO agent, etc. (delegate_to_agents, read_dashboard, set_marketing_plan, all of it). ALSO does credential recovery: if the email already belongs to a teammate who lost their secret, accepting REFRESHES it (client_id + connections stay; response sets recovery:true). Pass the recipient_instruction (or invite_token) to the colleague. A web fallback (invite_url) also exists.", "operationId": "invite_teammate", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email", "description": "The teammate's email \u2014 also the owner_email of the agent that will be created for them." }, "name": { "type": "string", "description": "Optional display name for the teammate." }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "marketing:read", "marketing:write", "sales:read", "sales:write", "office:read", "office:write" ] }, "description": "Access scopes to grant. Defaults to FULL access (all six) \u2014 the same level the inviter has." }, "expires_days": { "type": "integer", "default": 7, "description": "Days the invite link stays valid (1-30). Default 7." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/propose_plan_input": { "post": { "summary": "Bottom-up: a teammate agent proposes an input\/suggestion into the manager's shared marketing plan (e.g. SEO agent proposes a content priority). Appears in the manager Command Center under \"Agentide sisendid plaani\" for the manager to accept or decline. Status starts as \"proposed\".", "description": "Bottom-up: a teammate agent proposes an input\/suggestion into the manager's shared marketing plan (e.g. SEO agent proposes a content priority). Appears in the manager Command Center under \"Agentide sisendid plaani\" for the manager to accept or decline. Status starts as \"proposed\".", "operationId": "propose_plan_input", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "title" ], "properties": { "manager_token": { "type": "string", "description": "Optional. Public token of the manager dashboard whose plan to add the input to; inferred from your linked agent dashboard when possible." }, "agent_key": { "type": "string", "description": "Optional. The proposing agent's key (e.g. \"seo\"); inferred from your linked agent dashboard when possible." }, "pillar_key": { "type": "string", "description": "Optional pillar this input relates to." }, "title": { "type": "string", "description": "Short title of the proposal." }, "body": { "type": "string", "description": "Optional detail \/ rationale." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/apollo_search_people": { "post": { "summary": "Search for leads\/people in Apollo.io database by job title, company name, location, industry, seniority, and other filters. Returns matching contacts with names, titles, companies, emails, phone numbers, and LinkedIn profiles. Use this to build targeted prospect lists for outbound campaigns or to find decision-makers at specific companies.", "description": "Search for leads\/people in Apollo.io database by job title, company name, location, industry, seniority, and other filters. Returns matching contacts with names, titles, companies, emails, phone numbers, and LinkedIn profiles. Use this to build targeted prospect lists for outbound campaigns or to find decision-makers at specific companies.", "operationId": "apollo_search_people", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "person_titles": { "type": "array", "items": { "type": "string" }, "description": "Job titles to search for (e.g. [\"CEO\", \"CTO\", \"VP Marketing\"])" }, "organization_names": { "type": "array", "items": { "type": "string" }, "description": "Company names to filter by" }, "person_locations": { "type": "array", "items": { "type": "string" }, "description": "Locations to filter by (e.g. [\"San Francisco\", \"Estonia\"])" }, "organization_industry_tag_ids": { "type": "array", "items": { "type": "string" }, "description": "Industry tag IDs to filter by" }, "person_seniorities": { "type": "array", "items": { "type": "string" }, "description": "Seniority levels (e.g. [\"c_suite\", \"vp\", \"director\", \"manager\"])" }, "limit": { "type": "integer", "default": 25, "description": "Max number of results to return (default 25, max 100)" } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/apollo_search_companies": { "post": { "summary": "Search for companies in Apollo.io database by industry, employee count, location, revenue range, and technology stack. Returns matching organizations with company name, domain, industry, employee count, estimated revenue, and technologies used. Ideal for building account-based marketing (ABM) target lists or researching market segments.", "description": "Search for companies in Apollo.io database by industry, employee count, location, revenue range, and technology stack. Returns matching organizations with company name, domain, industry, employee count, estimated revenue, and technologies used. Ideal for building account-based marketing (ABM) target lists or researching market segments.", "operationId": "apollo_search_companies", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "organization_industry_tag_ids": { "type": "array", "items": { "type": "string" }, "description": "Industry tag IDs to filter by" }, "organization_num_employees_ranges": { "type": "array", "items": { "type": "string" }, "description": "Employee count ranges (e.g. [\"1,10\", \"11,50\", \"51,200\"])" }, "organization_locations": { "type": "array", "items": { "type": "string" }, "description": "HQ locations to filter by" }, "q_organization_keyword_tags": { "type": "array", "items": { "type": "string" }, "description": "Keyword tags for company search" }, "limit": { "type": "integer", "default": 25, "description": "Max number of results to return (default 25, max 100)" } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/apollo_enrich_person": { "post": { "summary": "Enrich a person record using Apollo.io by providing their email address. Returns comprehensive profile data including full name, current job title, company details, seniority level, department, social media links (LinkedIn, Twitter), phone numbers, and employment history. Use this to fill in missing contact data or verify lead information before outreach.", "description": "Enrich a person record using Apollo.io by providing their email address. Returns comprehensive profile data including full name, current job title, company details, seniority level, department, social media links (LinkedIn, Twitter), phone numbers, and employment history. Use this to fill in missing contact data or verify lead information before outreach.", "operationId": "apollo_enrich_person", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Email address of the person to enrich" } }, "required": [ "email" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/apollo_enrich_company": { "post": { "summary": "Enrich a company record using Apollo.io by providing the company domain. Returns detailed organization data including company name, description, industry, employee count, estimated annual revenue, founding year, technologies used, social media profiles, HQ location, and key contacts. Use this to research target accounts or enrich CRM data.", "description": "Enrich a company record using Apollo.io by providing the company domain. Returns detailed organization data including company name, description, industry, employee count, estimated annual revenue, founding year, technologies used, social media profiles, HQ location, and key contacts. Use this to research target accounts or enrich CRM data.", "operationId": "apollo_enrich_company", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain to enrich (e.g. \"example.com\")" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/snov_find_email": { "post": { "summary": "Find a professional email address using Snov.io by providing a person's first name, last name, and company domain. Returns matched email addresses with confidence scores and email type (personal vs generic). Essential for prospecting when you know who you want to reach but lack their direct email. Combines domain patterns with verification.", "description": "Find a professional email address using Snov.io by providing a person's first name, last name, and company domain. Returns matched email addresses with confidence scores and email type (personal vs generic). Essential for prospecting when you know who you want to reach but lack their direct email. Combines domain patterns with verification.", "operationId": "snov_find_email", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain (e.g. \"example.com\")" }, "first_name": { "type": "string", "description": "Person's first name" }, "last_name": { "type": "string", "description": "Person's last name" } }, "required": [ "domain", "first_name", "last_name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/snov_verify_email": { "post": { "summary": "Verify whether an email address is valid and deliverable using Snov.io. Returns verification status (valid, invalid, catch-all, unknown), SMTP check results, and risk assessment. Use this before sending outreach emails to reduce bounce rates, protect sender reputation, and ensure clean email lists. Checks MX records, SMTP responses, and mailbox existence.", "description": "Verify whether an email address is valid and deliverable using Snov.io. Returns verification status (valid, invalid, catch-all, unknown), SMTP check results, and risk assessment. Use this before sending outreach emails to reduce bounce rates, protect sender reputation, and ensure clean email lists. Checks MX records, SMTP responses, and mailbox existence.", "operationId": "snov_verify_email", "tags": [ "Email" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Email address to verify" } }, "required": [ "email" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/snov_domain_search": { "post": { "summary": "Find all publicly available email addresses associated with a company domain using Snov.io. Returns a list of emails found at the domain along with employee names, job titles, and departments when available. Great for mapping out an organization's team or building a contact list for a specific target company. Supports pagination for large organizations.", "description": "Find all publicly available email addresses associated with a company domain using Snov.io. Returns a list of emails found at the domain along with employee names, job titles, and departments when available. Great for mapping out an organization's team or building a contact list for a specific target company. Supports pagination for large organizations.", "operationId": "snov_domain_search", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain to search (e.g. \"example.com\")" }, "limit": { "type": "integer", "default": 100, "description": "Max number of emails to return (default 100)" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/snov_get_prospects": { "post": { "summary": "Retrieve prospects from a saved Snov.io prospect list by list ID. Returns contacts with their email addresses, names, positions, company info, and current outreach status. Use this to access previously curated lead lists, check the status of ongoing campaigns, or export prospect data for further processing in your CRM or outreach tools.", "description": "Retrieve prospects from a saved Snov.io prospect list by list ID. Returns contacts with their email addresses, names, positions, company info, and current outreach status. Use this to access previously curated lead lists, check the status of ongoing campaigns, or export prospect data for further processing in your CRM or outreach tools.", "operationId": "snov_get_prospects", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "list_id": { "type": "integer", "description": "Snov.io prospect list ID" }, "limit": { "type": "integer", "default": 100, "description": "Max number of prospects to return (default 100)" } }, "required": [ "list_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/clay_enrich_person": { "post": { "summary": "Enrich a person's profile using Clay's multi-source enrichment engine. Provide an email, LinkedIn URL, or name+company combination to get comprehensive data: verified email, phone numbers, LinkedIn profile, job title, company details, social profiles, and more. Clay aggregates data from 50+ providers for higher match rates than single-source tools.", "description": "Enrich a person's profile using Clay's multi-source enrichment engine. Provide an email, LinkedIn URL, or name+company combination to get comprehensive data: verified email, phone numbers, LinkedIn profile, job title, company details, social profiles, and more. Clay aggregates data from 50+ providers for higher match rates than single-source tools.", "operationId": "clay_enrich_person", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Person's email address" }, "linkedin_url": { "type": "string", "description": "Person's LinkedIn profile URL" }, "first_name": { "type": "string", "description": "Person's first name (use with last_name and company)" }, "last_name": { "type": "string", "description": "Person's last name (use with first_name and company)" }, "company": { "type": "string", "description": "Company name or domain (use with first_name and last_name)" } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/clay_enrich_company": { "post": { "summary": "Enrich a company profile using Clay's multi-source data aggregation. Provide a domain to get comprehensive company data including description, industry, employee count, revenue estimates, funding history, technologies used, social profiles, HQ location, and key decision-makers. Clay combines data from 50+ providers for the most complete company profiles available.", "description": "Enrich a company profile using Clay's multi-source data aggregation. Provide a domain to get comprehensive company data including description, industry, employee count, revenue estimates, funding history, technologies used, social profiles, HQ location, and key decision-makers. Clay combines data from 50+ providers for the most complete company profiles available.", "operationId": "clay_enrich_company", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain to enrich (e.g. \"example.com\")" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/clay_search_people": { "post": { "summary": "Search Clay's people database using a natural language query or structured filters. Returns matching contacts with names, titles, companies, emails, and LinkedIn profiles. Clay's search leverages multiple data sources for broader coverage. Use this for building prospect lists when you need to find people by role, industry, location, or other criteria.", "description": "Search Clay's people database using a natural language query or structured filters. Returns matching contacts with names, titles, companies, emails, and LinkedIn profiles. Clay's search leverages multiple data sources for broader coverage. Use this for building prospect lists when you need to find people by role, industry, location, or other criteria.", "operationId": "clay_search_people", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search query (e.g. \"marketing directors at SaaS companies in New York\")" }, "limit": { "type": "integer", "default": 25, "description": "Max number of results to return (default 25)" } }, "required": [ "query" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trends_interest_over_time": { "post": { "summary": "Get search interest over time for a keyword from Google Trends (12 months default). Returns a time series of relative search interest (0-100) showing how popular a keyword is over time. Great for seasonality analysis, trend detection, and comparing keyword popularity across periods. Optionally filter by country and custom timeframe. Works without a connection via scraping fallback, but SerpAPI key gives structured data.", "description": "Get search interest over time for a keyword from Google Trends (12 months default). Returns a time series of relative search interest (0-100) showing how popular a keyword is over time. Great for seasonality analysis, trend detection, and comparing keyword popularity across periods. Optionally filter by country and custom timeframe. Works without a connection via scraping fallback, but SerpAPI key gives structured data.", "operationId": "trends_interest_over_time", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Keyword to analyze (e.g. \"digital marketing\")" }, "geo": { "type": "string", "description": "Country code to filter by (e.g. \"US\", \"EE\", \"GB\"). Leave empty for worldwide." }, "timeframe": { "type": "string", "description": "Time range (e.g. \"today 12-m\", \"today 3-m\", \"today 5-y\", \"2023-01-01 2023-12-31\"). Default: \"today 12-m\"" } }, "required": [ "keyword" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trends_related_queries": { "post": { "summary": "Get related queries for a keyword from Google Trends \u2014 both \"rising\" (breakout\/surging) and \"top\" (most popular) related searches. Discover what people also search for alongside your keyword. Essential for content ideation, finding long-tail keywords, and understanding user intent around a topic. Works without a connection via scraping fallback.", "description": "Get related queries for a keyword from Google Trends \u2014 both \"rising\" (breakout\/surging) and \"top\" (most popular) related searches. Discover what people also search for alongside your keyword. Essential for content ideation, finding long-tail keywords, and understanding user intent around a topic. Works without a connection via scraping fallback.", "operationId": "trends_related_queries", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Keyword to find related queries for (e.g. \"SEO tools\")" }, "geo": { "type": "string", "description": "Country code to filter by (e.g. \"US\", \"EE\"). Leave empty for worldwide." } }, "required": [ "keyword" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trends_trending_searches": { "post": { "summary": "Get real-time trending searches in a country from Google Trends. Find viral topics, breaking news keywords, and currently surging search terms. Useful for newsjacking, real-time content marketing, and spotting opportunities to create timely content that rides trending waves. Defaults to US if no country specified.", "description": "Get real-time trending searches in a country from Google Trends. Find viral topics, breaking news keywords, and currently surging search terms. Useful for newsjacking, real-time content marketing, and spotting opportunities to create timely content that rides trending waves. Defaults to US if no country specified.", "operationId": "trends_trending_searches", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "geo": { "type": "string", "description": "Country code (e.g. \"US\", \"EE\", \"GB\", \"DE\"). Default: \"US\"" } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/keyword_planner_ideas": { "post": { "summary": "Get keyword ideas from Google Keyword Planner using seed keywords and\/or a URL. Returns keyword suggestions with monthly search volume, competition level (LOW\/MEDIUM\/HIGH), and CPC bid estimates. The gold standard for keyword research backed by actual Google Ads data. Requires a Google Ads connection with Keyword Planner access. Supports language and location targeting.", "description": "Get keyword ideas from Google Keyword Planner using seed keywords and\/or a URL. Returns keyword suggestions with monthly search volume, competition level (LOW\/MEDIUM\/HIGH), and CPC bid estimates. The gold standard for keyword research backed by actual Google Ads data. Requires a Google Ads connection with Keyword Planner access. Supports language and location targeting.", "operationId": "keyword_planner_ideas", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Seed keywords to generate ideas from (e.g. [\"digital marketing\", \"SEO\"])" }, "url": { "type": "string", "description": "Optional seed URL \u2014 Google will extract keywords from this page" }, "language": { "type": "string", "description": "Language criterion ID (e.g. \"1000\" for English, \"1043\" for Estonian). Default: \"1000\"" }, "location": { "type": "string", "description": "Location criterion ID (e.g. \"2233\" for Estonia, \"2840\" for USA). Default: \"2233\"" } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/keyword_planner_volumes": { "post": { "summary": "Get historical search volumes for specific keywords from Google Keyword Planner. Returns monthly search volume trends, competition index, and CPC estimates for each keyword. Use this when you already have a keyword list and need volume data to prioritize. Requires a Google Ads connection with Keyword Planner access.", "description": "Get historical search volumes for specific keywords from Google Keyword Planner. Returns monthly search volume trends, competition index, and CPC estimates for each keyword. Use this when you already have a keyword list and need volume data to prioritize. Requires a Google Ads connection with Keyword Planner access.", "operationId": "keyword_planner_volumes", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Keywords to get search volumes for (e.g. [\"SEO audit\", \"keyword research tool\"])" } }, "required": [ "keywords" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/ubersuggest_keywords": { "post": { "summary": "Get keyword suggestions from Ubersuggest (Neil Patel's tool) with search volume, SEO difficulty score, paid difficulty, and CPC estimates. Provides a broader set of keyword ideas including questions, prepositions, and comparisons. Works without a connection via scraping fallback, but an API key gives structured data. Good complement to Google Keyword Planner.", "description": "Get keyword suggestions from Ubersuggest (Neil Patel's tool) with search volume, SEO difficulty score, paid difficulty, and CPC estimates. Provides a broader set of keyword ideas including questions, prepositions, and comparisons. Works without a connection via scraping fallback, but an API key gives structured data. Good complement to Google Keyword Planner.", "operationId": "ubersuggest_keywords", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Seed keyword to get suggestions for (e.g. \"content marketing\")" }, "country": { "type": "string", "description": "Country code in lowercase (e.g. \"us\", \"ee\", \"gb\"). Default: \"us\"" } }, "required": [ "keyword" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/ubersuggest_domain": { "post": { "summary": "Get a domain overview from Ubersuggest \u2014 estimated monthly organic traffic, domain authority score, total backlinks, top organic keywords, and top pages by traffic. Great for competitive analysis, benchmarking your site against competitors, and finding content gaps. Works without a connection via scraping fallback.", "description": "Get a domain overview from Ubersuggest \u2014 estimated monthly organic traffic, domain authority score, total backlinks, top organic keywords, and top pages by traffic. Great for competitive analysis, benchmarking your site against competitors, and finding content gaps. Works without a connection via scraping fallback.", "operationId": "ubersuggest_domain", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain to analyze (e.g. \"example.com\", without https:\/\/)" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trustpilot_find_business": { "post": { "summary": "Find a business on Trustpilot by domain name. Returns the business unit ID, TrustScore (1-5), total review count, star distribution, and display name. Use the returned business unit ID for subsequent trustpilot_get_reviews or trustpilot_get_profile calls. Essential for competitor reputation monitoring or auditing your own brand presence on Trustpilot.", "description": "Find a business on Trustpilot by domain name. Returns the business unit ID, TrustScore (1-5), total review count, star distribution, and display name. Use the returned business unit ID for subsequent trustpilot_get_reviews or trustpilot_get_profile calls. Essential for competitor reputation monitoring or auditing your own brand presence on Trustpilot.", "operationId": "trustpilot_find_business", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Business domain to search for (e.g. \"example.com\")" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trustpilot_get_reviews": { "post": { "summary": "Get recent reviews for a business on Trustpilot. Returns individual reviews with star rating (1-5), review title, full text, date created, reviewer display name, and language. Requires a business unit ID from trustpilot_find_business. Use to analyze customer sentiment, identify recurring complaints, or monitor review trends over time.", "description": "Get recent reviews for a business on Trustpilot. Returns individual reviews with star rating (1-5), review title, full text, date created, reviewer display name, and language. Requires a business unit ID from trustpilot_find_business. Use to analyze customer sentiment, identify recurring complaints, or monitor review trends over time.", "operationId": "trustpilot_get_reviews", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "business_unit_id": { "type": "string", "description": "Trustpilot business unit ID (from trustpilot_find_business)" }, "limit": { "type": "integer", "default": 20, "description": "Number of reviews to return (default 20)" } }, "required": [ "business_unit_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trustpilot_get_profile": { "post": { "summary": "Get the full business profile from Trustpilot including TrustScore, star rating, total review count, business categories, website URL, response rate to reviews, and claimed status. Provides a comprehensive overview of a company's Trustpilot reputation. Requires a business unit ID from trustpilot_find_business.", "description": "Get the full business profile from Trustpilot including TrustScore, star rating, total review count, business categories, website URL, response rate to reviews, and claimed status. Provides a comprehensive overview of a company's Trustpilot reputation. Requires a business unit ID from trustpilot_find_business.", "operationId": "trustpilot_get_profile", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "business_unit_id": { "type": "string", "description": "Trustpilot business unit ID (from trustpilot_find_business)" } }, "required": [ "business_unit_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/trustpilot_reply_review": { "post": { "summary": "Reply to a specific Trustpilot review on behalf of the business. Requires OAuth business account authentication (api_key, api_secret, username, password in connection credentials). Use to respond to customer feedback, address complaints publicly, or thank customers for positive reviews. The reply will appear publicly on the Trustpilot review page.", "description": "Reply to a specific Trustpilot review on behalf of the business. Requires OAuth business account authentication (api_key, api_secret, username, password in connection credentials). Use to respond to customer feedback, address complaints publicly, or thank customers for positive reviews. The reply will appear publicly on the Trustpilot review page.", "operationId": "trustpilot_reply_review", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "review_id": { "type": "string", "description": "ID of the review to reply to" }, "message": { "type": "string", "description": "Reply message text" } }, "required": [ "review_id", "message" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/g2_get_product": { "post": { "summary": "Get product information from G2 by product ID. Returns product name, overall rating, total review count, category, description, and vendor details. Use to understand how a software product is perceived in the B2B market, compare ratings across competitors, or track your product's G2 positioning over time.", "description": "Get product information from G2 by product ID. Returns product name, overall rating, total review count, category, description, and vendor details. Use to understand how a software product is perceived in the B2B market, compare ratings across competitors, or track your product's G2 positioning over time.", "operationId": "g2_get_product", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "product_id": { "type": "string", "description": "G2 product ID" } }, "required": [ "product_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/g2_get_reviews": { "post": { "summary": "Get recent G2 reviews for a product. Returns individual reviews with star rating, title, comment text (pros, cons, overall), reviewer role, company size, industry, and date submitted. Use to analyze detailed B2B user feedback, identify feature gaps, or gather competitive intelligence from verified user reviews.", "description": "Get recent G2 reviews for a product. Returns individual reviews with star rating, title, comment text (pros, cons, overall), reviewer role, company size, industry, and date submitted. Use to analyze detailed B2B user feedback, identify feature gaps, or gather competitive intelligence from verified user reviews.", "operationId": "g2_get_reviews", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "product_id": { "type": "string", "description": "G2 product ID" }, "limit": { "type": "integer", "default": 20, "description": "Number of reviews to return (default 20)" } }, "required": [ "product_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/g2_get_competitors": { "post": { "summary": "Get competitor products listed on G2 for a given product. Returns alternative products in the same category with their ratings, review counts, and market presence scores. Use to map the competitive landscape, identify emerging competitors, or compare your product positioning against alternatives in the G2 marketplace.", "description": "Get competitor products listed on G2 for a given product. Returns alternative products in the same category with their ratings, review counts, and market presence scores. Use to map the competitive landscape, identify emerging competitors, or compare your product positioning against alternatives in the G2 marketplace.", "operationId": "g2_get_competitors", "tags": [ "Marketing" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "product_id": { "type": "string", "description": "G2 product ID to find competitors for" } }, "required": [ "product_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/capterra_get_product": { "post": { "summary": "Get product information from Capterra by product slug. Returns product name, overall rating, total review count, pricing information, features list, and category. Uses official API when available, falls back to web scraping. Use to research software products, compare pricing tiers, or assess market positioning on Capterra.", "description": "Get product information from Capterra by product slug. Returns product name, overall rating, total review count, pricing information, features list, and category. Uses official API when available, falls back to web scraping. Use to research software products, compare pricing tiers, or assess market positioning on Capterra.", "operationId": "capterra_get_product", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string", "description": "Capterra product slug (from the URL, e.g. \"hubspot-crm\")" } }, "required": [ "slug" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/capterra_get_reviews": { "post": { "summary": "Get recent Capterra reviews for a product by slug. Returns individual reviews with overall rating, pros, cons, reviewer industry, company size, and date. Uses official API when available, falls back to web scraping. Use to analyze user sentiment, identify common pain points, or gather competitive intelligence from verified Capterra reviews.", "description": "Get recent Capterra reviews for a product by slug. Returns individual reviews with overall rating, pros, cons, reviewer industry, company size, and date. Uses official API when available, falls back to web scraping. Use to analyze user sentiment, identify common pain points, or gather competitive intelligence from verified Capterra reviews.", "operationId": "capterra_get_reviews", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string", "description": "Capterra product slug (from the URL, e.g. \"hubspot-crm\")" }, "limit": { "type": "integer", "default": 20, "description": "Number of reviews to return (default 20)" } }, "required": [ "slug" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_calendars": { "post": { "summary": "List all Google Calendars the user has access to. Returns calendar id, summary, description, primary flag, and access role. Use to discover which calendar to query, or to answer \"which calendars do I have?\" Returns the primary calendar plus any shared or subscribed calendars.", "description": "List all Google Calendars the user has access to. Returns calendar id, summary, description, primary flag, and access role. Use to discover which calendar to query, or to answer \"which calendars do I have?\" Returns the primary calendar plus any shared or subscribed calendars.", "operationId": "list_calendars", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_events": { "post": { "summary": "List Google Calendar events between two dates (RFC3339 date-times). Returns event id, title, description, start, end, location, attendees (with RSVP status), and html_link. Use for calendar review, meeting prep, or answering \"what events do I have this week\/month?\" Date tokens \"today\", \"yesterday\", \"NdaysAgo\" are supported.", "description": "List Google Calendar events between two dates (RFC3339 date-times). Returns event id, title, description, start, end, location, attendees (with RSVP status), and html_link. Use for calendar review, meeting prep, or answering \"what events do I have this week\/month?\" Date tokens \"today\", \"yesterday\", \"NdaysAgo\" are supported.", "operationId": "list_events", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "description": "Start date\/time (RFC3339, e.g. \"2026-04-21T00:00:00Z\") or token (\"today\", \"yesterday\", \"7daysAgo\")." }, "end_date": { "type": "string", "description": "End date\/time (RFC3339) or token." }, "max_results": { "type": "integer", "default": 50 } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_event": { "post": { "summary": "Create a new Google Calendar event on the primary (or connection-scoped) calendar. Required: summary, start, end (both RFC3339 date-times). Optional: description, location, timezone (default UTC), attendees (array of emails \u2014 invitations are sent). Returns the created event with id and html_link.", "description": "Create a new Google Calendar event on the primary (or connection-scoped) calendar. Required: summary, start, end (both RFC3339 date-times). Optional: description, location, timezone (default UTC), attendees (array of emails \u2014 invitations are sent). Returns the created event with id and html_link.", "operationId": "create_event", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "Event title." }, "start": { "type": "string", "description": "Start date-time in RFC3339 (e.g. \"2026-04-22T14:00:00Z\")." }, "end": { "type": "string", "description": "End date-time in RFC3339." }, "description": { "type": "string" }, "location": { "type": "string" }, "timezone": { "type": "string", "default": "UTC" }, "attendees": { "type": "array", "description": "List of attendee email addresses.", "items": { "type": "string" } } }, "required": [ "summary", "start", "end" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_upcoming_events": { "post": { "summary": "Get the next N upcoming Google Calendar events, ordered by start time, starting from now. Returns event id, title, description, start, end, location, attendees, and html_link. Use for daily briefings or answering \"what do I have coming up?\" or \"what is my next meeting?\"", "description": "Get the next N upcoming Google Calendar events, ordered by start time, starting from now. Returns event id, title, description, start, end, location, attendees, and html_link. Use for daily briefings or answering \"what do I have coming up?\" or \"what is my next meeting?\"", "operationId": "get_upcoming_events", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "max_results": { "type": "integer", "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_drive_files": { "post": { "summary": "List files in a Google Drive folder (or root if folder_id omitted). Returns file id, name, mime type, size, modified time, and web view link. Use for browsing folders, finding documents, or answering \"what files are in my Drive?\"", "description": "List files in a Google Drive folder (or root if folder_id omitted). Returns file id, name, mime type, size, modified time, and web view link. Use for browsing folders, finding documents, or answering \"what files are in my Drive?\"", "operationId": "list_drive_files", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "folder_id": { "type": "string", "description": "Drive folder id. Omit to list root-level files." }, "limit": { "type": "integer", "default": 50 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_drive": { "post": { "summary": "Search Google Drive files by keyword across file names. Returns matching files with id, name, mime type, and web view link. Use to locate a specific document by name when folder path is unknown.", "description": "Search Google Drive files by keyword across file names. Returns matching files with id, name, mime type, and web view link. Use to locate a specific document by name when folder path is unknown.", "operationId": "search_drive", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search term to match against file names." }, "limit": { "type": "integer", "default": 20 } }, "required": [ "query" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_drive_file_content": { "post": { "summary": "Download and return the text content of a Google Drive file. Google Docs are exported as plain text, Google Sheets as CSV (with parsed structured_data), Google Slides as text. Regular files (PDF, TXT, etc.) are downloaded as-is. Returns file_name, mime_type, content, structured_data, size, and web_view_link.", "description": "Download and return the text content of a Google Drive file. Google Docs are exported as plain text, Google Sheets as CSV (with parsed structured_data), Google Slides as text. Regular files (PDF, TXT, etc.) are downloaded as-is. Returns file_name, mime_type, content, structured_data, size, and web_view_link.", "operationId": "get_drive_file_content", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "file_id": { "type": "string", "description": "Drive file id (from list_drive_files or search_drive)." }, "mime_type": { "type": "string", "description": "Optional override of the export mime type." } }, "required": [ "file_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_drive_folders": { "post": { "summary": "List subfolders inside a Google Drive folder (or root if parent_id omitted). Returns folder id, name, and modified time. Use to navigate a folder hierarchy or answer \"what folders do I have in Drive?\"", "description": "List subfolders inside a Google Drive folder (or root if parent_id omitted). Returns folder id, name, and modified time. Use to navigate a folder hierarchy or answer \"what folders do I have in Drive?\"", "operationId": "list_drive_folders", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "parent_id": { "type": "string", "description": "Parent folder id. Omit to list root-level folders." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_drive_file": { "post": { "summary": "Create a new file in Google Drive with text content. Returns file_id, name, mime_type and web_view_link. For an empty Google Doc pass mime_type \"application\/vnd.google-apps.document\"; for a Google Sheet use \"application\/vnd.google-apps.spreadsheet\". Requires a connected google_drive integration.", "description": "Create a new file in Google Drive with text content. Returns file_id, name, mime_type and web_view_link. For an empty Google Doc pass mime_type \"application\/vnd.google-apps.document\"; for a Google Sheet use \"application\/vnd.google-apps.spreadsheet\". Requires a connected google_drive integration.", "operationId": "create_drive_file", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "File name." }, "content": { "type": "string", "description": "Text content of the file (ignored for native Google Doc\/Sheet types)." }, "mime_type": { "type": "string", "description": "MIME type. Default text\/plain.", "default": "text\/plain" }, "folder_id": { "type": "string", "description": "Optional parent folder id." } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_drive_file": { "post": { "summary": "Overwrite the content of an existing Drive file (regular files like txt\/csv\/json \u2014 not native Google Docs\/Sheets). Returns bytes_written and web_view_link. Requires a connected google_drive integration.", "description": "Overwrite the content of an existing Drive file (regular files like txt\/csv\/json \u2014 not native Google Docs\/Sheets). Returns bytes_written and web_view_link. Requires a connected google_drive integration.", "operationId": "update_drive_file", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "file_id": { "type": "string", "description": "Drive file id to overwrite." }, "content": { "type": "string", "description": "New full content." }, "mime_type": { "type": "string", "description": "Optional MIME type." } }, "required": [ "file_id", "content" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_drive_folder": { "post": { "summary": "Create a new folder in Google Drive. Returns folder_id and web_view_link. Requires a connected google_drive integration.", "description": "Create a new folder in Google Drive. Returns folder_id and web_view_link. Requires a connected google_drive integration.", "operationId": "create_drive_folder", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Folder name." }, "parent_id": { "type": "string", "description": "Optional parent folder id." } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/delete_drive_file": { "post": { "summary": "Permanently delete a Drive file or folder by id. This cannot be undone. Requires a connected google_drive integration.", "description": "Permanently delete a Drive file or folder by id. This cannot be undone. Requires a connected google_drive integration.", "operationId": "delete_drive_file", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "file_id": { "type": "string", "description": "Drive file or folder id to delete." } }, "required": [ "file_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/read_sheet": { "post": { "summary": "Read a range from a Google Sheet. Returns the 2D values array (rows of cells). Range uses A1 notation, e.g. \"Sheet1!A1:D20\" or \"A:D\". Requires a connected google_sheets integration.", "description": "Read a range from a Google Sheet. Returns the 2D values array (rows of cells). Range uses A1 notation, e.g. \"Sheet1!A1:D20\" or \"A:D\". Requires a connected google_sheets integration.", "operationId": "read_sheet", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "spreadsheet_id": { "type": "string", "description": "Spreadsheet id (from the URL)." }, "range": { "type": "string", "description": "A1 range, e.g. \"Sheet1!A1:D20\"." } }, "required": [ "spreadsheet_id", "range" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_sheet": { "post": { "summary": "Write (overwrite) values into a Google Sheet range. values is a 2D array of rows, e.g. [[\"Name\",\"Email\"],[\"Mari\",\"mari@x.ee\"]]. Uses USER_ENTERED so formulas\/dates are parsed. Requires a connected google_sheets integration.", "description": "Write (overwrite) values into a Google Sheet range. values is a 2D array of rows, e.g. [[\"Name\",\"Email\"],[\"Mari\",\"mari@x.ee\"]]. Uses USER_ENTERED so formulas\/dates are parsed. Requires a connected google_sheets integration.", "operationId": "update_sheet", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "spreadsheet_id": { "type": "string" }, "range": { "type": "string", "description": "A1 range where the top-left cell anchors the write, e.g. \"Sheet1!A1\"." }, "values": { "type": "array", "description": "2D array of rows.", "items": { "type": "array", "items": { "type": [ "string", "number", "boolean", "null" ] } } } }, "required": [ "spreadsheet_id", "range", "values" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/append_sheet": { "post": { "summary": "Append rows to the end of a table in a Google Sheet. values is a 2D array of rows. New rows are inserted after the last row overlapping the given range. Requires a connected google_sheets integration.", "description": "Append rows to the end of a table in a Google Sheet. values is a 2D array of rows. New rows are inserted after the last row overlapping the given range. Requires a connected google_sheets integration.", "operationId": "append_sheet", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "spreadsheet_id": { "type": "string" }, "range": { "type": "string", "description": "A1 range of the table, e.g. \"Sheet1!A1\"." }, "values": { "type": "array", "description": "2D array of rows to append.", "items": { "type": "array", "items": { "type": [ "string", "number", "boolean", "null" ] } } } }, "required": [ "spreadsheet_id", "range", "values" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_spreadsheet": { "post": { "summary": "Create a new Google Spreadsheet, optionally seeding the first sheet from A1 with a 2D values array. Returns spreadsheet_id and spreadsheet_url. Requires a connected google_sheets integration.", "description": "Create a new Google Spreadsheet, optionally seeding the first sheet from A1 with a 2D values array. Returns spreadsheet_id and spreadsheet_url. Requires a connected google_sheets integration.", "operationId": "create_spreadsheet", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "description": "Spreadsheet title." }, "values": { "type": "array", "description": "Optional initial rows.", "items": { "type": "array", "items": { "type": [ "string", "number", "boolean", "null" ] } } } }, "required": [ "title" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_doc": { "post": { "summary": "Read a Google Doc by id. Returns title and plain-text content. Requires a connected google_docs integration.", "description": "Read a Google Doc by id. Returns title and plain-text content. Requires a connected google_docs integration.", "operationId": "get_doc", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "document_id": { "type": "string", "description": "Google Doc id (from the URL)." } }, "required": [ "document_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/create_doc": { "post": { "summary": "Create a new Google Doc with optional initial body text. Returns document_id and web_view_link. Requires a connected google_docs integration.", "description": "Create a new Google Doc with optional initial body text. Returns document_id and web_view_link. Requires a connected google_docs integration.", "operationId": "create_doc", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "description": "Document title." }, "content": { "type": "string", "description": "Optional initial body text." } }, "required": [ "title" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/append_doc_text": { "post": { "summary": "Append text to the end of a Google Doc body. Returns chars_written. Requires a connected google_docs integration.", "description": "Append text to the end of a Google Doc body. Returns chars_written. Requires a connected google_docs integration.", "operationId": "append_doc_text", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "document_id": { "type": "string" }, "text": { "type": "string", "description": "Text to append (include \"\\n\" for new paragraphs)." } }, "required": [ "document_id", "text" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/notion_search": { "post": { "summary": "Search the connected Notion workspace for pages and databases by keyword. Returns a results array of Notion objects (pages and databases mixed). Optional filter narrows results by object type ({\"property\":\"object\",\"value\":\"page\"} or \"database\"). Use to locate specific Notion content.", "description": "Search the connected Notion workspace for pages and databases by keyword. Returns a results array of Notion objects (pages and databases mixed). Optional filter narrows results by object type ({\"property\":\"object\",\"value\":\"page\"} or \"database\"). Use to locate specific Notion content.", "operationId": "notion_search", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search text (empty string returns all accessible items)." }, "filter": { "type": "object", "description": "Notion filter object, e.g. {\"property\":\"object\",\"value\":\"page\"}." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/notion_list_databases": { "post": { "summary": "List all Notion databases the integration has access to in the connected workspace. Returns an array of database objects with id, title, properties schema, and parent. Use for database discovery before querying.", "description": "List all Notion databases the integration has access to in the connected workspace. Returns an array of database objects with id, title, properties schema, and parent. Use for database discovery before querying.", "operationId": "notion_list_databases", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/notion_get_page": { "post": { "summary": "Get a specific Notion page by id. Returns the page object with its properties, parent, created\/last-edited timestamps, and cover\/icon. Does not include block content (use notion_search or the blocks API for content).", "description": "Get a specific Notion page by id. Returns the page object with its properties, parent, created\/last-edited timestamps, and cover\/icon. Does not include block content (use notion_search or the blocks API for content).", "operationId": "notion_get_page", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "page_id": { "type": "string", "description": "Notion page id." } }, "required": [ "page_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/notion_query_database": { "post": { "summary": "Query rows in a Notion database with optional filter and sorts. Returns a results array of page objects (rows). Filter syntax follows the Notion API (e.g. {\"property\":\"Status\",\"select\":{\"equals\":\"Done\"}}). Sorts is an array of {property, direction} objects. Use for reporting and pulling structured data from Notion tables.", "description": "Query rows in a Notion database with optional filter and sorts. Returns a results array of page objects (rows). Filter syntax follows the Notion API (e.g. {\"property\":\"Status\",\"select\":{\"equals\":\"Done\"}}). Sorts is an array of {property, direction} objects. Use for reporting and pulling structured data from Notion tables.", "operationId": "notion_query_database", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "database_id": { "type": "string", "description": "Notion database id." }, "filter": { "type": "object", "description": "Notion filter object." }, "sorts": { "type": "array", "description": "Array of Notion sort objects, e.g. [{\"property\":\"Name\",\"direction\":\"ascending\"}].", "items": { "type": "object" } } }, "required": [ "database_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/notion_create_page": { "post": { "summary": "Create a new page in a Notion database. Required: parent_id (database id), properties (Notion property object matching the database schema). Optional children (array of block objects for page body). Returns the created page object.", "description": "Create a new page in a Notion database. Required: parent_id (database id), properties (Notion property object matching the database schema). Optional children (array of block objects for page body). Returns the created page object.", "operationId": "notion_create_page", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "parent_id": { "type": "string", "description": "Parent Notion database id." }, "properties": { "type": "object", "description": "Page properties matching the target database schema, e.g. {\"Name\":{\"title\":[{\"text\":{\"content\":\"New task\"}}]}}." }, "children": { "type": "array", "description": "Optional array of Notion block objects for page body content.", "items": { "type": "object" } } }, "required": [ "parent_id", "properties" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/check_facebook_ads": { "post": { "summary": "Check whether a brand, company, or website is actively advertising on Facebook or Instagram using the public Facebook Ad Library. Accepts a domain (e.g. example.com) or a brand\/page name (e.g. \"Acme Coffee\"). Returns is_advertising (bool), total_found, sample_ads with creative snippets + delivery dates + spend ranges + platforms, and a search_url for manual verification in the public Ad Library UI. Works for any public advertiser in the specified country \u2014 no permission from the target needed. Default country EE, status ALL, limit 10. Use when asked \"is X running Facebook ads?\", \"what ads is competitor Y showing?\", \"check if this prospect advertises on Meta.\"", "description": "Check whether a brand, company, or website is actively advertising on Facebook or Instagram using the public Facebook Ad Library. Accepts a domain (e.g. example.com) or a brand\/page name (e.g. \"Acme Coffee\"). Returns is_advertising (bool), total_found, sample_ads with creative snippets + delivery dates + spend ranges + platforms, and a search_url for manual verification in the public Ad Library UI. Works for any public advertiser in the specified country \u2014 no permission from the target needed. Default country EE, status ALL, limit 10. Use when asked \"is X running Facebook ads?\", \"what ads is competitor Y showing?\", \"check if this prospect advertises on Meta.\"", "operationId": "check_facebook_ads", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "description": "Domain (example.com) or brand\/page name to search for in the Ad Library." }, "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code (e.g. EE, US, DE, GB). Ads are disclosed per-country. Default EE.", "default": "EE" }, "status": { "type": "string", "enum": [ "ALL", "ACTIVE", "INACTIVE" ], "description": "Filter by ad delivery status. ALL = both running and stopped ads. ACTIVE = currently delivering only. INACTIVE = stopped only. Default ALL.", "default": "ALL" }, "limit": { "type": "integer", "description": "Max sample ads to return (1-50). Default 10.", "default": 10, "minimum": 1, "maximum": 50 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_ariregister_companies": { "post": { "summary": "Search the Estonian Business Registry (ariregister.rik.ee) for companies by EMTAK sector code and annual turnover range. Returns name, reg_code, address, email, phone, emtak_code, turnover (EUR, from official annual reports). Requires free RIK credentials \u2014 register at ariregister.rik.ee\/est\/contract\/step1 and add username\/password to your \u00c4riregister connection. Use for Estonian B2B prospecting: \"leia IT firmad (EMTAK 6201) k\u00e4ibega 200k\u2013600k\", \"find construction companies (EMTAK 4120) with turnover above 1M EUR\", \"millised Eesti logistikafirmad on keskmise suurusega\". Companies without a published annual report are excluded.", "description": "Search the Estonian Business Registry (ariregister.rik.ee) for companies by EMTAK sector code and annual turnover range. Returns name, reg_code, address, email, phone, emtak_code, turnover (EUR, from official annual reports). Requires free RIK credentials \u2014 register at ariregister.rik.ee\/est\/contract\/step1 and add username\/password to your \u00c4riregister connection. Use for Estonian B2B prospecting: \"leia IT firmad (EMTAK 6201) k\u00e4ibega 200k\u2013600k\", \"find construction companies (EMTAK 4120) with turnover above 1M EUR\", \"millised Eesti logistikafirmad on keskmise suurusega\". Companies without a published annual report are excluded.", "operationId": "search_ariregister_companies", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "emtak_code", "min_turnover" ], "properties": { "emtak_code": { "type": "string", "description": "EMTAK sector code (e.g. \"6201\" software development, \"4120\" construction, \"4711\" food retail, \"4941\" road freight). See emtak.rik.ee." }, "min_turnover": { "type": "integer", "description": "Minimum annual turnover (m\u00fc\u00fcgitulu) in EUR, inclusive.", "minimum": 0 }, "max_turnover": { "type": "integer", "description": "Maximum annual turnover in EUR, inclusive. Omit for no upper bound.", "minimum": 0 }, "limit": { "type": "integer", "description": "Max companies to return (1\u201350). Default 20.", "default": 20, "minimum": 1, "maximum": 50 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_ariregister_by_name": { "post": { "summary": "Search the Estonian Business Registry by company name keyword. No credentials needed \u2014 uses the public autocomplete endpoint. Returns up to 10 active companies with name, reg_code, and address. Use for quick lookups: \"kas Bolt Technology on registreeritud\", \"leia k\u00f5ik Eesti firmad nimega Tark\", \"find companies with Invest in name\".", "description": "Search the Estonian Business Registry by company name keyword. No credentials needed \u2014 uses the public autocomplete endpoint. Returns up to 10 active companies with name, reg_code, and address. Use for quick lookups: \"kas Bolt Technology on registreeritud\", \"leia k\u00f5ik Eesti firmad nimega Tark\", \"find companies with Invest in name\".", "operationId": "search_ariregister_by_name", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "keyword" ], "properties": { "keyword": { "type": "string", "description": "Company name or partial name to search for." }, "limit": { "type": "integer", "description": "Max results (1\u201310). Default 10.", "default": 10, "minimum": 1, "maximum": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/contribute_skill": { "post": { "summary": "Publish a skill (a SKILL.md \/ skill.md playbook you built in your own Cowork) into THIS project's shared team library so teammates can use it. Each call adds a new VERSION under the same slug \u2014 so you and a colleague can each contribute your take on e.g. \"seo-audit\", and the manager later promotes the best with promote_skill. Whenever you discover a better repeatable procedure mid-work, contribute it IMMEDIATELY under the existing slug (write-through, like memory_write) \u2014 do not wait for session end. Returns the slug + version.", "description": "Publish a skill (a SKILL.md \/ skill.md playbook you built in your own Cowork) into THIS project's shared team library so teammates can use it. Each call adds a new VERSION under the same slug \u2014 so you and a colleague can each contribute your take on e.g. \"seo-audit\", and the manager later promotes the best with promote_skill. Whenever you discover a better repeatable procedure mid-work, contribute it IMMEDIATELY under the existing slug (write-through, like memory_write) \u2014 do not wait for session end. Returns the slug + version.", "operationId": "contribute_skill", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "name", "content" ], "properties": { "name": { "type": "string", "description": "Human title, e.g. \"SEO Audit\"." }, "content": { "type": "string", "description": "The full skill markdown (YAML front matter + body)." }, "slug": { "type": "string", "description": "Stable id to group versions (e.g. \"seo-audit\"). Defaults to a slug of the name \u2014 use the SAME slug to add a version to an existing skill." }, "summary": { "type": "string", "description": "One line on what changed \/ why this version is better." }, "channel": { "type": "string", "description": "Memory channel this skill belongs to (e.g. social, seo, content, paid, analytics) \u2014 only that channel's agents + orchestrators see it. Omit for a global skill visible to everyone. Defaults to your own memory_role channel when you have one." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_team_skills": { "post": { "summary": "List the project's shared team skills visible to you \u2014 every slug with its channel, versions, who contributed each, and which version is canonical (the manager's pick). Channel agents see global skills + their own channel's; orchestrators see all. Your memory_bootstrap already carries a compact index of these \u2014 use this tool for the full picture.", "description": "List the project's shared team skills visible to you \u2014 every slug with its channel, versions, who contributed each, and which version is canonical (the manager's pick). Channel agents see global skills + their own channel's; orchestrators see all. Your memory_bootstrap already carries a compact index of these \u2014 use this tool for the full picture.", "operationId": "list_team_skills", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string", "description": "Optional \u2014 restrict to one skill slug." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_team_skill": { "post": { "summary": "Fetch the full markdown of a team skill so you can read it, install it (save as .claude\/skills\/{slug}\/SKILL.md), or combine several versions into a better one. Defaults to the canonical version, else the latest.", "description": "Fetch the full markdown of a team skill so you can read it, install it (save as .claude\/skills\/{slug}\/SKILL.md), or combine several versions into a better one. Defaults to the canonical version, else the latest.", "operationId": "get_team_skill", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "slug" ], "properties": { "slug": { "type": "string" }, "version": { "type": "integer", "description": "Optional specific version. Omit for canonical\/latest." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/promote_skill": { "post": { "summary": "MANAGER ONLY. Mark one version of a skill as the team CANONICAL (\"the best\") \u2014 this is what list_team_skills highlights and what new agents install. To combine the best of several contributions: read them with get_team_skill, synthesize a merged version, contribute_skill it, then promote_skill that new version. Demotes the previous canonical.", "description": "MANAGER ONLY. Mark one version of a skill as the team CANONICAL (\"the best\") \u2014 this is what list_team_skills highlights and what new agents install. To combine the best of several contributions: read them with get_team_skill, synthesize a merged version, contribute_skill it, then promote_skill that new version. Demotes the previous canonical.", "operationId": "promote_skill", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "slug", "version" ], "properties": { "slug": { "type": "string" }, "version": { "type": "integer" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/check_skill_updates": { "post": { "summary": "Check whether the skills you installed are still current \u2014 run this in your recurring task so an updated skill reaches agents on the old version. Pass the skills you have (slug + the version string you saved in their front matter). Returns which are stale (with the current version + how to re-fetch) plus any NEW canonical team skills you don't have yet. Re-install the stale\/new ones (platform: re-download the URL; team: get_team_skill(slug)) and save the new version in the front matter.", "description": "Check whether the skills you installed are still current \u2014 run this in your recurring task so an updated skill reaches agents on the old version. Pass the skills you have (slug + the version string you saved in their front matter). Returns which are stale (with the current version + how to re-fetch) plus any NEW canonical team skills you don't have yet. Re-install the stale\/new ones (platform: re-download the URL; team: get_team_skill(slug)) and save the new version in the front matter.", "operationId": "check_skill_updates", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "installed": { "type": "array", "description": "Skills you currently have: [{slug, version}]. version is the string from the skill's front matter (sharksapi_version). Omit to just get current versions of all your team's canonical skills.", "items": { "type": "object" } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/submit_draft": { "post": { "summary": "Submit a piece of content for the marketing manager to approve \u2014 a social post, web text, newsletter, blog\/news article, ad text, event text, campaign message or SEO text change. It appears in the manager Command Center \"Vajab kinnitamist\" panel and the Approvals view with preview, channel, deadline and priority. If the content's channel is on AUTOPILOT (Autonomy slider), the draft is auto-approved on submit and the response tells you to proceed to publish \u2014 no human review happens. If a memory constraint marks this specific content as an exception that a human must see, pass require_approval=true to force the review queue anyway. Content must be anonymous marketing copy \u2014 never include applicant personal data.", "description": "Submit a piece of content for the marketing manager to approve \u2014 a social post, web text, newsletter, blog\/news article, ad text, event text, campaign message or SEO text change. It appears in the manager Command Center \"Vajab kinnitamist\" panel and the Approvals view with preview, channel, deadline and priority. If the content's channel is on AUTOPILOT (Autonomy slider), the draft is auto-approved on submit and the response tells you to proceed to publish \u2014 no human review happens. If a memory constraint marks this specific content as an exception that a human must see, pass require_approval=true to force the review queue anyway. Content must be anonymous marketing copy \u2014 never include applicant personal data.", "operationId": "submit_draft", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "type", "title", "body" ], "properties": { "type": { "type": "string", "enum": [ "social_post", "web_text", "newsletter", "blog", "ad_text", "event_text", "campaign_message", "seo_change" ], "description": "Content type." }, "channel": { "type": "string", "description": "Where it goes: facebook, instagram, linkedin, email, web, blog, google_ads, meta_ads, event." }, "title": { "type": "string", "description": "Short headline shown in the list." }, "body": { "type": "string", "description": "The full draft text to be reviewed." }, "related_activity": { "type": "string", "description": "Related campaign\/activity name (optional)." }, "deadline": { "type": "string", "description": "Due date YYYY-MM-DD or today\/daysAgo tokens (optional)." }, "priority": { "type": "string", "enum": [ "low", "medium", "high" ], "description": "low | medium | high (default medium)." }, "manager_token": { "type": "string", "description": "Manager dashboard public_token to attach this draft to (optional; defaults to the project's manager dashboard)." }, "require_approval": { "type": "boolean", "description": "Force human review even on an autopilot channel. Use when a memory constraint marks this content as an exception (sensitive topic, pricing, legal, etc.)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_drafts": { "post": { "summary": "List content drafts for this project, newest\/most-urgent first. Filter by status (pending, changes_requested, approved, scheduled, rejected, published) \u2014 omit to get the open queue (pending + changes_requested).", "description": "List content drafts for this project, newest\/most-urgent first. Filter by status (pending, changes_requested, approved, scheduled, rejected, published) \u2014 omit to get the open queue (pending + changes_requested).", "operationId": "list_drafts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "draft_id": { "type": "integer", "description": "Optional shortcut: when supplied, this inspects that one draft (same result as review_draft with action=inspect)." }, "status": { "type": "string", "description": "Filter by a single status, or \"open\" for the review queue." }, "limit": { "type": "integer", "description": "Max rows (default 25)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/review_draft": { "post": { "summary": "Manager action on a draft: inspect (read only), approve, request_changes (with a note), edit (replace the body), schedule (set scheduled_at), reject (with a note), or publish (mark published after the channel posting is done). cancel withdraws an already-approved or scheduled draft (same as reject; for linked social posts it also cancels the post before it reaches the channel). If you only have draft_id and need to see what it is, call inspect or omit action. retry applies only to drafts with a linked social post and is done from the unlocked manager dashboard, not here.", "description": "Manager action on a draft: inspect (read only), approve, request_changes (with a note), edit (replace the body), schedule (set scheduled_at), reject (with a note), or publish (mark published after the channel posting is done). cancel withdraws an already-approved or scheduled draft (same as reject; for linked social posts it also cancels the post before it reaches the channel). If you only have draft_id and need to see what it is, call inspect or omit action. retry applies only to drafts with a linked social post and is done from the unlocked manager dashboard, not here.", "operationId": "review_draft", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "draft_id" ], "properties": { "draft_id": { "type": "integer", "description": "The draft to act on." }, "action": { "type": "string", "enum": [ "inspect", "approve", "request_changes", "edit", "schedule", "reject", "cancel", "publish", "retry" ], "description": "The review action. Omit for inspect\/read-only." }, "note": { "type": "string", "description": "Feedback for request_changes \/ reject." }, "body": { "type": "string", "description": "New body text for the edit action." }, "scheduled_at": { "type": "string", "description": "Datetime for the schedule action (e.g. 2026-06-20 09:00)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/revise_draft": { "post": { "summary": "Agent action: revise a draft the manager sent back (status changes_requested) \u2014 text (body), media (media_urls), and\/or the requested time (scheduled_at). The SAME draft\/social_post id is kept and the replaced version is archived in the card's revision history, so NEVER cancel + resubmit just to change content: revise instead. The draft returns to \"pending\" for re-approval; a linked social post follows (caption\/media\/time) and returns to the manager queue. This is how you act on the manager's feedback shown in read_dashboard action_items.", "description": "Agent action: revise a draft the manager sent back (status changes_requested) \u2014 text (body), media (media_urls), and\/or the requested time (scheduled_at). The SAME draft\/social_post id is kept and the replaced version is archived in the card's revision history, so NEVER cancel + resubmit just to change content: revise instead. The draft returns to \"pending\" for re-approval; a linked social post follows (caption\/media\/time) and returns to the manager queue. This is how you act on the manager's feedback shown in read_dashboard action_items.", "operationId": "revise_draft", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "draft_id" ], "properties": { "draft_id": { "type": "integer", "description": "The draft to revise." }, "body": { "type": "string", "description": "The revised full text. Omit to keep the current text (media\/time-only revision)." }, "media_urls": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "Replacement media for the linked social post (public HTTPS URLs). Same rules as submit_social_post: reel\/story exactly 1, carousel at least 2, Instagram images must be JPEG." }, "scheduled_at": { "type": "string", "description": "New requested publish time (future datetime); applied when the manager approves." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/submit_social_post": { "post": { "summary": "Submit a Facebook or Instagram post, reel, carousel, or story for human approval. Instagram images must be JPEG (PNG is rejected by Meta); Instagram has no native scheduling, so scheduled posts are published by this platform at scheduled_at. This never publishes directly: an unlocked password-protected manager dashboard must schedule or publish it.", "description": "Submit a Facebook or Instagram post, reel, carousel, or story for human approval. Instagram images must be JPEG (PNG is rejected by Meta); Instagram has no native scheduling, so scheduled posts are published by this platform at scheduled_at. This never publishes directly: an unlocked password-protected manager dashboard must schedule or publish it.", "operationId": "submit_social_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "channel" ], "properties": { "channel": { "type": "string", "enum": [ "facebook", "instagram" ] }, "type": { "type": "string", "enum": [ "post", "reel", "carousel", "story" ], "description": "Default post. Use reel, carousel, or story only when the media shape needs it." }, "caption": { "type": "string", "description": "Post caption." }, "media_urls": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "link": { "type": "string", "description": "Facebook HTTPS link; Instagram does not support link posts." }, "first_comment": { "type": "string", "maxLength": 2200, "description": "Optional comment posted by the platform right after publishing (e.g. the full link, since Instagram captions are not clickable). Not supported for stories. Requires pages_manage_engagement (Facebook) \/ instagram_manage_comments (Instagram) on the connection." }, "publish_mode": { "type": "string", "enum": [ "draft", "schedule", "publish" ], "description": "Default draft. Use schedule with scheduled_at or publish when requesting immediate publication after approval." }, "scheduled_at": { "type": "string", "description": "Future datetime, required only for schedule." }, "idempotency_key": { "type": "string", "maxLength": 100 }, "group_key": { "type": "string", "maxLength": 100, "description": "Give EVERY channel\/format variant of the same content piece the same group_key (e.g. \"story-pakk-2026-08-26\"): the approvals view then shows ONE card with one Approve\/Cancel\/Schedule for the whole group instead of a card per variant. Always set this when submitting the same content to several channels." }, "internal_label": { "type": "string", "maxLength": 120, "description": "Human-readable card title for the approvals dashboard, e.g. \"Story, Paide Vesi, N 27.08 kl 12:15\". Dashboard-only \u2014 NEVER published to the channel. Always set this for media-only posts (stories, reels) whose caption is empty, so the reviewer is not shown a raw media URL." }, "share_to_story": { "type": "boolean", "description": "Reels only: after publishing, the platform also shares the same 9:16 video to the channel's Story automatically (no separate story submission needed). Best effort \u2014 a story failure never fails the published reel; see story_post_id \/ story_error on the record." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_social_posts": { "post": { "summary": "List approval-first social publishing records for this project. Does not expose credentials or provider tokens.", "description": "List approval-first social publishing records for this project. Does not expose credentials or provider tokens.", "operationId": "list_social_posts", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending_approval", "approved", "scheduled", "queued", "publishing", "published", "failed", "cancelled" ] }, "channel": { "type": "string", "enum": [ "facebook", "instagram" ] }, "group_key": { "type": "string", "description": "Only the variants submitted with this group_key." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "page": { "type": "integer", "minimum": 1, "description": "Optional 1-based page number. Use with limit for pagination." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/cancel_social_post": { "post": { "summary": "Cancel a social post you submitted before it reaches the channel (pending_approval, approved, scheduled, or failed). The linked content draft becomes rejected and the row will never publish. Posts already publishing or published cannot be cancelled here. NEVER cancel just to change something: revise_draft(draft_id=content_draft_id) updates text, media_urls, and scheduled_at under the SAME id, with the replaced version kept in the card's revision history.", "description": "Cancel a social post you submitted before it reaches the channel (pending_approval, approved, scheduled, or failed). The linked content draft becomes rejected and the row will never publish. Posts already publishing or published cannot be cancelled here. NEVER cancel just to change something: revise_draft(draft_id=content_draft_id) updates text, media_urls, and scheduled_at under the SAME id, with the replaced version kept in the card's revision history.", "operationId": "cancel_social_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "social_post_id" ], "properties": { "social_post_id": { "type": "integer", "minimum": 1 }, "note": { "type": "string", "description": "Why it is cancelled (stored as the review note)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_social_post": { "post": { "summary": "Get one project-scoped social publishing record and its approval status. Does not publish or mutate it. Failed rows carry last_error_code + last_error_message (Meta's own error text, e.g. \"(#200) Requires pages_manage_posts\") so you can tell a permission problem from a provider outage without asking a human.", "description": "Get one project-scoped social publishing record and its approval status. Does not publish or mutate it. Failed rows carry last_error_code + last_error_message (Meta's own error text, e.g. \"(#200) Requires pages_manage_posts\") so you can tell a permission problem from a provider outage without asking a human.", "operationId": "get_social_post", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "social_post_id" ], "properties": { "social_post_id": { "type": "integer", "minimum": 1 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/retry_first_comment": { "post": { "summary": "Post (or re-post) the first comment on an ALREADY PUBLISHED social post whose automatic first comment failed \u2014 first_comment_id is empty and first_comment_error explains why (commonly a missing pages_manage_engagement \/ instagram_manage_comments permission; fix the permission first, then call this). Optionally pass first_comment to replace the stored text. Refuses when the comment is already live or the post is not published.", "description": "Post (or re-post) the first comment on an ALREADY PUBLISHED social post whose automatic first comment failed \u2014 first_comment_id is empty and first_comment_error explains why (commonly a missing pages_manage_engagement \/ instagram_manage_comments permission; fix the permission first, then call this). Optionally pass first_comment to replace the stored text. Refuses when the comment is already live or the post is not published.", "operationId": "retry_first_comment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "social_post_id" ], "properties": { "social_post_id": { "type": "integer", "minimum": 1 }, "first_comment": { "type": "string", "maxLength": 2200, "description": "Optional replacement comment text; omit to use the text stored on the post." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_social_comments": { "post": { "summary": "Read the actual comments (text, author, time, like count, hidden state) on a Facebook page post or Instagram media via the Meta Graph API. Works on any post of the connected page\/account \u2014 pass the provider post id (from get_facebook_posts, get_instagram_posts, or a published social_post's provider_post_id). If you only have a SharksAPI social_post_id, pass that and the platform infers channel + provider_post_id. Instagram returns replies inline; for Facebook pass a comment_id as post_id to read that thread's replies. Use this instead of browser automation for community management.", "description": "Read the actual comments (text, author, time, like count, hidden state) on a Facebook page post or Instagram media via the Meta Graph API. Works on any post of the connected page\/account \u2014 pass the provider post id (from get_facebook_posts, get_instagram_posts, or a published social_post's provider_post_id). If you only have a SharksAPI social_post_id, pass that and the platform infers channel + provider_post_id. Instagram returns replies inline; for Facebook pass a comment_id as post_id to read that thread's replies. Use this instead of browser automation for community management.", "operationId": "get_social_comments", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "facebook", "instagram" ] }, "post_id": { "type": "string", "description": "Provider post\/media id. Facebook also accepts a comment id here to list that comment's replies." }, "social_post_id": { "type": "integer", "minimum": 1, "description": "Optional SharksAPI social post id; used to infer channel and provider_post_id for a published post." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "Comments per page, default 25." }, "after": { "type": "string", "description": "Pagination cursor from a previous call's next_after." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/reply_social_comment": { "post": { "summary": "Reply to a comment on the project's Facebook page or Instagram business account, as the page\/account. Facebook replies land in the comment's thread; Instagram replies attach to the top-level comment (threads are one level deep). Requires pages_manage_engagement (Facebook) \/ instagram_manage_comments (Instagram) on the connection. This is an external write: it goes through the human approval gate unless the social channel is on autopilot.", "description": "Reply to a comment on the project's Facebook page or Instagram business account, as the page\/account. Facebook replies land in the comment's thread; Instagram replies attach to the top-level comment (threads are one level deep). Requires pages_manage_engagement (Facebook) \/ instagram_manage_comments (Instagram) on the connection. This is an external write: it goes through the human approval gate unless the social channel is on autopilot.", "operationId": "reply_social_comment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "channel", "comment_id", "message" ], "properties": { "channel": { "type": "string", "enum": [ "facebook", "instagram" ] }, "comment_id": { "type": "string", "description": "The comment to reply to, from get_social_comments." }, "message": { "type": "string", "maxLength": 2200, "description": "Reply text posted publicly as the page\/account." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/hide_social_comment": { "post": { "summary": "Hide (or unhide) a comment on the project's Facebook page or Instagram business account \u2014 for spam and abuse moderation. Hiding is reversible and the commenter still sees their own comment; deletion is deliberately not offered. Requires pages_manage_engagement (Facebook) \/ instagram_manage_comments (Instagram). External write: goes through the human approval gate unless the social channel is on autopilot.", "description": "Hide (or unhide) a comment on the project's Facebook page or Instagram business account \u2014 for spam and abuse moderation. Hiding is reversible and the commenter still sees their own comment; deletion is deliberately not offered. Requires pages_manage_engagement (Facebook) \/ instagram_manage_comments (Instagram). External write: goes through the human approval gate unless the social channel is on autopilot.", "operationId": "hide_social_comment", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "channel", "comment_id" ], "properties": { "channel": { "type": "string", "enum": [ "facebook", "instagram" ] }, "comment_id": { "type": "string", "description": "The comment to hide or unhide, from get_social_comments." }, "hide": { "type": "boolean", "description": "Default true. Pass false to unhide a previously hidden comment." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/add_plan_activity": { "post": { "summary": "Add an activity to the marketing plan calendar (Annual\/Monthly view): a recurring, seasonal or one-time activity placed in one or more months, e.g. \"Monthly newsletter\", \"Open-house campaign (June)\", \"SEO refresh\". Optionally link it to a strategy-card task via task_ref so the status is derived from that task. Anonymous marketing activities only \u2014 no applicant PII.", "description": "Add an activity to the marketing plan calendar (Annual\/Monthly view): a recurring, seasonal or one-time activity placed in one or more months, e.g. \"Monthly newsletter\", \"Open-house campaign (June)\", \"SEO refresh\". Optionally link it to a strategy-card task via task_ref so the status is derived from that task. Anonymous marketing activities only \u2014 no applicant PII.", "operationId": "add_plan_activity", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "title", "kind" ], "properties": { "title": { "type": "string", "description": "Activity name." }, "kind": { "type": "string", "enum": [ "recurring", "seasonal", "one_time" ], "description": "recurring | seasonal | one_time." }, "months": { "type": "array", "items": { "type": "integer" }, "description": "Month numbers 1-12 it appears in (e.g. [6] for June, [1..12] for recurring)." }, "date": { "type": "string", "description": "Specific date YYYY-MM-DD or today\/daysAgo tokens (optional)." }, "channel": { "type": "string", "description": "Channel (optional)." }, "agent_key": { "type": "string", "description": "Owning agent key, e.g. seo, content, social, paid (optional)." }, "status": { "type": "string", "enum": [ "planned", "in_progress", "done" ], "description": "planned | in_progress | done (default planned). Ignored when task_ref is provided because status is then derived from the linked task." }, "content_draft_id": { "type": "integer", "description": "Link to a content draft (optional)." }, "notes": { "type": "string", "description": "Notes (optional)." }, "manager_token": { "type": "string", "description": "Manager dashboard token (optional; defaults to the project's manager dashboard)." }, "task_ref": { "type": [ "object", "null" ], "description": "Link this activity to a strategy-card task. When set, activity status is derived from that task. Pass null to unlink and make status manual again.", "properties": { "token": { "type": "string", "description": "Child dashboard public_token where the strategy card lives." }, "widget_id": { "type": "integer", "description": "Strategy-card widget_id." }, "task_id": { "type": "integer", "description": "Task id on that strategy card." } }, "required": [ "token", "widget_id", "task_id" ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/list_plan_activities": { "post": { "summary": "List marketing plan activities for this project (the Annual\/Monthly calendar data), ordered by date. Optionally filter by month (1-12) or status. If an activity is linked with task_ref, its status\/attention are derived from that strategy task.", "description": "List marketing plan activities for this project (the Annual\/Monthly calendar data), ordered by date. Optionally filter by month (1-12) or status. If an activity is linked with task_ref, its status\/attention are derived from that strategy task.", "operationId": "list_plan_activities", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "month": { "type": "integer", "description": "Only activities in this month (1-12)." }, "status": { "type": "string", "description": "planned | in_progress | done." }, "limit": { "type": "integer", "description": "Maximum rows to return (default all, cap 100)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_plan_activity": { "post": { "summary": "Update a plan activity \u2014 change its title, months, date, channel, linked draft, notes or task_ref. If task_ref is linked, status becomes derived from the strategy task; manual status updates are blocked until task_ref is cleared with null.", "description": "Update a plan activity \u2014 change its title, months, date, channel, linked draft, notes or task_ref. If task_ref is linked, status becomes derived from the strategy task; manual status updates are blocked until task_ref is cleared with null.", "operationId": "update_plan_activity", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "activity_id" ], "properties": { "activity_id": { "type": "integer" }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "planned", "in_progress", "done" ] }, "months": { "type": "array", "items": { "type": "integer" } }, "date": { "type": "string" }, "channel": { "type": "string" }, "content_draft_id": { "type": "integer" }, "notes": { "type": "string" }, "task_ref": { "type": [ "object", "null" ], "description": "Link this activity to a strategy-card task. When set, activity status is derived from that task. Pass null to unlink and make status manual again.", "properties": { "token": { "type": "string", "description": "Child dashboard public_token where the strategy card lives." }, "widget_id": { "type": "integer", "description": "Strategy-card widget_id." }, "task_id": { "type": "integer", "description": "Task id on that strategy card." } }, "required": [ "token", "widget_id", "task_id" ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/get_plan_document": { "post": { "summary": "Read the team's full marketing-plan DOCUMENT (markdown) \u2014 the living plan text shown and edited on the \/plan page and downloadable as PDF. Returns the markdown, when it was last updated, when subagent tasks were last synced to it, and dirty=true when the document changed after the last sync (meaning the manager must re-align subagent tasks). Structured plan data (KPIs, pillars) lives in set_marketing_plan; this is the narrative document.", "description": "Read the team's full marketing-plan DOCUMENT (markdown) \u2014 the living plan text shown and edited on the \/plan page and downloadable as PDF. Returns the markdown, when it was last updated, when subagent tasks were last synced to it, and dirty=true when the document changed after the last sync (meaning the manager must re-align subagent tasks). Structured plan data (KPIs, pillars) lives in set_marketing_plan; this is the narrative document.", "operationId": "get_plan_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "manager_token": { "type": "string", "description": "Manager dashboard token (optional; defaults to the project's manager dashboard)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/update_plan_document": { "post": { "summary": "Create or replace the marketing-plan DOCUMENT (full markdown). This is the dynamic plan the human also edits on the \/plan page. CONTRACT: whenever the document changes, the manager (Turundusjuht) must re-align subagent tasks with the new plan (delegate_to_agents \/ manage_strategy_card \/ update_strategy_task \/ add_plan_activity) and then call mark_plan_tasks_synced. If you are the manager and sync tasks in the same run, pass mark_synced=true. Otherwise the plan is flagged \"tasks not synced\" on the dashboard and a team-memory reminder is written for the manager's next run. Anonymous marketing content only \u2014 no personal data.", "description": "Create or replace the marketing-plan DOCUMENT (full markdown). This is the dynamic plan the human also edits on the \/plan page. CONTRACT: whenever the document changes, the manager (Turundusjuht) must re-align subagent tasks with the new plan (delegate_to_agents \/ manage_strategy_card \/ update_strategy_task \/ add_plan_activity) and then call mark_plan_tasks_synced. If you are the manager and sync tasks in the same run, pass mark_synced=true. Otherwise the plan is flagged \"tasks not synced\" on the dashboard and a team-memory reminder is written for the manager's next run. Anonymous marketing content only \u2014 no personal data.", "operationId": "update_plan_document", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "document" ], "properties": { "document": { "type": "string", "description": "The full plan document as markdown (replaces the previous version, max ~200k chars)." }, "manager_token": { "type": "string", "description": "Manager dashboard token (optional; defaults to the project's manager dashboard)." }, "mark_synced": { "type": "boolean", "description": "Pass true only when subagent tasks are ALREADY re-aligned with this version in the same run (manager doing both at once)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/mark_plan_tasks_synced": { "post": { "summary": "Manager-only bookkeeping: declare that subagent tasks are now re-aligned with the current marketing-plan document. Clears the \"tasks not synced\" flag on the dashboard and archives the team-memory reminder. Call this AFTER actually updating the affected agents' tasks (delegate_to_agents \/ update_strategy_task \/ add_plan_activity) \u2014 never before.", "description": "Manager-only bookkeeping: declare that subagent tasks are now re-aligned with the current marketing-plan document. Clears the \"tasks not synced\" flag on the dashboard and archives the team-memory reminder. Call this AFTER actually updating the affected agents' tasks (delegate_to_agents \/ update_strategy_task \/ add_plan_activity) \u2014 never before.", "operationId": "mark_plan_tasks_synced", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "manager_token": { "type": "string", "description": "Manager dashboard token (optional; defaults to the project's manager dashboard)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/check_ai_overview": { "post": { "summary": "Google AI Overview check for a fixed keyword set: for each keyword, does Google show an AI Overview and which domains it cites (live DataForSEO advanced SERP, async AI Overview loaded). Returns keywords_with_ai_overview and, per domain you pass, cited_in_keywords + cited_share_pct + cited_urls \u2014 the deterministic AI-visibility metric for competitor_watch (\"AI Overview tsiteeringud\"). Pass the client domain plus competitors in domains. Default location Estonia (2233), language Estonian (et). Costs one advanced SERP call per keyword; keep to \u2264 20 keywords and reuse the same set month to month so the numbers are comparable.", "description": "Google AI Overview check for a fixed keyword set: for each keyword, does Google show an AI Overview and which domains it cites (live DataForSEO advanced SERP, async AI Overview loaded). Returns keywords_with_ai_overview and, per domain you pass, cited_in_keywords + cited_share_pct + cited_urls \u2014 the deterministic AI-visibility metric for competitor_watch (\"AI Overview tsiteeringud\"). Pass the client domain plus competitors in domains. Default location Estonia (2233), language Estonian (et). Costs one advanced SERP call per keyword; keep to \u2264 20 keywords and reuse the same set month to month so the numbers are comparable.", "operationId": "check_ai_overview", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "keywords", "domains" ], "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Category search terms to test (max 20), e.g. [\"soojuspump hind\", \"\u00f5hk-vesi soojuspump\"]." }, "domains": { "type": "array", "items": { "type": "string" }, "description": "Domains to score for citations (client first, then competitors), e.g. [\"ait-nord.ee\", \"kliimamarket.ee\"]." }, "location_code": { "type": "integer", "default": 2233, "description": "DataForSEO location code (2233 = Estonia, 2246 = Finland, 2428 = Latvia, 2440 = Lithuania)." }, "language_code": { "type": "string", "default": "et", "description": "Language code (et, en, fi, ru, ...)." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/score_citability": { "post": { "summary": "Citability score 0\u2013100 of one or more public pages: how easily an AI answer engine (ChatGPT, Perplexity, Gemini, Google AI Overviews) can lift a citable fact from the page. Checks answer-first structure (H1 + direct answer paragraph), concrete statistics, author attribution, freshness (published\/modified date), Q&A blocks (FAQPage \/ question headings), structure (H2s, lists, tables, length), entity schema (Organization\/LocalBusiness\/Article\/Service JSON-LD) and crawlability (noindex, canonical). Returns per-page score + grade + check details + recommendations, and average_score across pages. Works on any domain, so use it on competitors too. Typical input: the homepage and the main service page.", "description": "Citability score 0\u2013100 of one or more public pages: how easily an AI answer engine (ChatGPT, Perplexity, Gemini, Google AI Overviews) can lift a citable fact from the page. Checks answer-first structure (H1 + direct answer paragraph), concrete statistics, author attribution, freshness (published\/modified date), Q&A blocks (FAQPage \/ question headings), structure (H2s, lists, tables, length), entity schema (Organization\/LocalBusiness\/Article\/Service JSON-LD) and crawlability (noindex, canonical). Returns per-page score + grade + check details + recommendations, and average_score across pages. Works on any domain, so use it on competitors too. Typical input: the homepage and the main service page.", "operationId": "score_citability", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "string" }, "description": "Full URLs to score (1\u20135)." }, "url": { "type": "string", "description": "Single URL alternative to urls." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_bootstrap": { "post": { "summary": "Call FIRST at session start (if no context was handed to you in the A2A task payload): returns the composed working context for this workspace within a ~2500-token budget \u2014 all global constraints (incl. the autonomy setting) and facts, your channel's open task_state entries, the latest decisions\/results and lessons. Orchestrator may pass role to compose the package for a channel agent before delegating (attach it to the A2A task payload).", "description": "Call FIRST at session start (if no context was handed to you in the A2A task payload): returns the composed working context for this workspace within a ~2500-token budget \u2014 all global constraints (incl. the autonomy setting) and facts, your channel's open task_state entries, the latest decisions\/results and lessons. Orchestrator may pass role to compose the package for a channel agent before delegating (attach it to the A2A task payload).", "operationId": "memory_bootstrap", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "description": "Ignored. Your role and scope come from the token you authenticate with; no dashboard token is needed here." }, "agent_key": { "type": "string", "description": "Ignored. Your agent\/channel identity comes from the token you authenticate with; use role only when an orchestrator composes context for another role." }, "role": { "type": "string", "description": "Orchestrator only: compose for this channel role (e.g. seo, google_ads) to attach to a delegated task." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_write": { "post": { "summary": "Write-through memory: record every important decision, result, lesson, fact or task_state IMMEDIATELY while working (not in a batch at session end \u2014 an interrupted session must not lose memory). Style: short, factual, dated, measurable \u2014 an entry, not an essay. Types: fact (client standing data), constraint (orchestrator\/human only \u2014 bans, budgets, autonomy), decision (+why), result (measured), lesson, task_state (what was done, what is next; link task_id). Channel agents write their own channel: and private scopes, PLUS scope global for shared knowledge types fact|decision|lesson \u2014 use global for general rules every agent must see; task_state\/result stay in your channel, and you can amend or supersede only global entries you created yourself. Duplicates get a supersede suggestion instead of a second copy.", "description": "Write-through memory: record every important decision, result, lesson, fact or task_state IMMEDIATELY while working (not in a batch at session end \u2014 an interrupted session must not lose memory). Style: short, factual, dated, measurable \u2014 an entry, not an essay. Types: fact (client standing data), constraint (orchestrator\/human only \u2014 bans, budgets, autonomy), decision (+why), result (measured), lesson, task_state (what was done, what is next; link task_id). Channel agents write their own channel: and private scopes, PLUS scope global for shared knowledge types fact|decision|lesson \u2014 use global for general rules every agent must see; task_state\/result stay in your channel, and you can amend or supersede only global entries you created yourself. Duplicates get a supersede suggestion instead of a second copy.", "operationId": "memory_write", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "scope", "type", "content" ], "properties": { "scope": { "type": "string", "description": "global | channel: | private:" }, "type": { "type": "string", "enum": [ "fact", "decision", "result", "lesson", "task_state", "constraint" ] }, "title": { "type": "string", "description": "Short, searchable. If omitted, a short title is inferred from content." }, "content": { "type": "string", "description": "Markdown. Dated + measurable, e.g. \"2026-07-09: valisime 5 fookusm\u00e4rks\u00f5na, sest GSC n\u00e4itas pos 8\u201315; siht TOP5 60 p\u00e4evaga\". Content over ~1000 chars is split into multiple bounded entries." }, "date": { "type": "string", "format": "date", "description": "Optional event date (YYYY-MM-DD). If content does not already start with a date, the platform prefixes this date before saving." }, "task_id": { "type": "integer", "description": "Command-center task this task_state belongs to (dashboard strategy task id)." }, "supersedes_id": { "type": "string", "description": "Replace this older entry (it gets archived)." }, "pinned": { "type": "boolean", "description": "Keep hot \u2014 exempt from consolidation demotion." }, "expires_at": { "type": "string", "description": "ISO datetime for temporary facts." }, "source_session": { "type": "string", "description": "Session identifier for traceability." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_get": { "post": { "summary": "Read one memory entry by id if it is visible to your role. Use this when memory_bootstrap or memory_search gives you an entry id and you need the full current record.", "description": "Read one memory entry by id if it is visible to your role. Use this when memory_bootstrap or memory_search gives you an entry id and you need the full current record.", "operationId": "memory_get", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_search": { "post": { "summary": "Full-text search over every memory entry you may read, INCLUDING the archive. Use when bootstrap notes there are more entries, or you need history on a specific keyword\/campaign\/decision.", "description": "Full-text search over every memory entry you may read, INCLUDING the archive. Use when bootstrap notes there are more entries, or you need history on a specific keyword\/campaign\/decision.", "operationId": "memory_search", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string" }, "scope": { "type": "string", "description": "Optional scope filter." }, "type": { "type": "string", "enum": [ "fact", "decision", "result", "lesson", "task_state", "constraint" ], "description": "Optional type filter." }, "limit": { "type": "integer", "description": "Optional result cap. Default 25, maximum 25." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_update": { "post": { "summary": "Amend an existing memory entry you are allowed to write (title\/content\/status\/pinned\/expires_at\/task_id). Prefer this over a duplicate write; use memory_write with supersedes_id when the old entry should be replaced wholesale.", "description": "Amend an existing memory entry you are allowed to write (title\/content\/status\/pinned\/expires_at\/task_id). Prefer this over a duplicate write; use memory_write with supersedes_id when the old entry should be replaced wholesale.", "operationId": "memory_update", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "content": { "type": "string" }, "status": { "type": "string", "enum": [ "hot", "active", "archived" ] }, "pinned": { "type": "boolean" }, "expires_at": { "type": "string" }, "task_id": { "type": "integer" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_archive": { "post": { "summary": "Archive a memory entry (same write permissions as memory_update). Archived entries stay searchable but leave the bootstrap package.", "description": "Archive a memory entry (same write permissions as memory_update). Archived entries stay searchable but leave the bootstrap package.", "operationId": "memory_archive", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/memory_review": { "post": { "summary": "Orchestrator only: list duplicates, expired and stale-hot entries so the turundusjuht can consolidate (merge with supersedes_id, archive, re-pin). Run this in the weekly manager loop.", "description": "Orchestrator only: list duplicates, expired and stale-hot entries so the turundusjuht can consolidate (merge with supersedes_id, archive, re-pin). Run this in the weekly manager loop.", "operationId": "memory_review", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/search_serp_google": { "post": { "summary": "Live Google organic SERP for a keyword. Returns the top N ranked results with position, URL, title, description, and domain. Use this when the user asks \"who ranks for X?\", \"what does Google show for keyword Y in Estonia?\", for SERP snapshots before\/after content launches, or for competitor discovery on a specific query. Default location is Estonia (2233), language Estonian (et). For bulk search volumes use keyword_search_volume instead; for a whole domain use domain_keywords.", "description": "Live Google organic SERP for a keyword. Returns the top N ranked results with position, URL, title, description, and domain. Use this when the user asks \"who ranks for X?\", \"what does Google show for keyword Y in Estonia?\", for SERP snapshots before\/after content launches, or for competitor discovery on a specific query. Default location is Estonia (2233), language Estonian (et). For bulk search volumes use keyword_search_volume instead; for a whole domain use domain_keywords.", "operationId": "search_serp_google", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Search query to run on Google" }, "location_code": { "type": "integer", "default": 2233, "description": "DataForSEO location code (2233 = Estonia, 2840 = US, 2826 = UK)" }, "location": { "type": "string", "description": "Alias for location_code. Accepts Estonia, United States, United Kingdom, or a numeric DataForSEO location code." }, "language_code": { "type": "string", "default": "et", "description": "Language code (et, en, ru, fi, ...)" }, "language": { "type": "string", "description": "Alias for language_code (et, en, ru, fi, ...)." }, "depth": { "type": "integer", "default": 10, "description": "How many SERP items to return (max 100)" }, "limit": { "type": "integer", "default": 10, "description": "Alias for depth: how many SERP items to return (max 100)." } }, "required": [ "keyword" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/keyword_search_volume": { "post": { "summary": "Google Ads search volume, CPC (EUR\/USD), and competition level for a batch of keywords. Returns per-keyword monthly search volume, competition index (0\u2013100), keyword difficulty, and average CPC. Use this for keyword research before writing content, ad group planning, prioritising content calendars, or answering \"how much traffic could rank X bring us?\". Pair with search_serp_google for the full \"can we rank?\" check.", "description": "Google Ads search volume, CPC (EUR\/USD), and competition level for a batch of keywords. Returns per-keyword monthly search volume, competition index (0\u2013100), keyword difficulty, and average CPC. Use this for keyword research before writing content, ad group planning, prioritising content calendars, or answering \"how much traffic could rank X bring us?\". Pair with search_serp_google for the full \"can we rank?\" check.", "operationId": "keyword_search_volume", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "Keywords to look up (batch supported, typically up to ~1000)" }, "location_code": { "type": "integer", "default": 2233, "description": "DataForSEO location code (2233 = Estonia)" }, "language_code": { "type": "string", "default": "et", "description": "Language code (et, en, ru, fi, ...)" } }, "required": [ "keywords" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/domain_keywords": { "post": { "summary": "Organic keywords a domain currently ranks for on Google, via DataForSEO Labs. Returns keyword, current position, monthly search volume, estimated traffic, CPC, and landing page URL. Use this for competitor audits (\"what is competitor.ee ranking for?\"), content gap analysis, and finding the highest-traffic pages of any domain. For your own ranking changes over time, prefer get_seoshark_keywords which tracks trends.", "description": "Organic keywords a domain currently ranks for on Google, via DataForSEO Labs. Returns keyword, current position, monthly search volume, estimated traffic, CPC, and landing page URL. Use this for competitor audits (\"what is competitor.ee ranking for?\"), content gap analysis, and finding the highest-traffic pages of any domain. For your own ranking changes over time, prefer get_seoshark_keywords which tracks trends.", "operationId": "domain_keywords", "tags": [ "SEO" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "target": { "type": "string", "description": "Domain to inspect (e.g. example.ee \u2014 no protocol)" }, "location_code": { "type": "integer", "default": 2233, "description": "DataForSEO location code (2233 = Estonia)" }, "language_code": { "type": "string", "default": "et", "description": "Language code (et, en, ru, fi, ...)" }, "limit": { "type": "integer", "default": 50, "description": "Max keywords to return (1\u20131000)" } }, "required": [ "target" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } }, "\/openapi\/tools\/backlinks_summary": { "post": { "summary": "Backlink profile overview for any domain. Returns total backlinks, referring domains, referring main domains, referring IPs, DataForSEO rank score, broken backlinks count, and anchor text diversity signals. Use this for link-building diligence, auditing a prospect\/competitor before outreach, or answering \"how strong is example.com's backlink profile?\". For a full per-link list prefer get_seoshark_backlinks when the domain is your own.", "description": "Backlink profile overview for any domain. Returns total backlinks, referring domains, referring main domains, referring IPs, DataForSEO rank score, broken backlinks count, and anchor text diversity signals. Use this for link-building diligence, auditing a prospect\/competitor before outreach, or answering \"how strong is example.com's backlink profile?\". For a full per-link list prefer get_seoshark_backlinks when the domain is your own.", "operationId": "backlinks_summary", "tags": [ "Other" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "target": { "type": "string", "description": "Domain to inspect (e.g. competitor.com)" } }, "required": [ "target" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application\/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" }, "message": { "type": "string" } } } } } }, "400": { "description": "Bad request - invalid parameters", "content": { "application\/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } } } } }, "401": { "description": "Unauthorized - invalid or missing API token" }, "500": { "description": "Internal server error" } } } } } }