{
  "info": {
    "name": "Botsonic — mcp.ai",
    "description": "REST API for the Botsonic MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/botsonic",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "botsonic_bulk_upload_urls",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/upload/urls",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "upload",
            "urls"
          ]
        },
        "description": "Tool to bulk upload URLs for bot training. Use when you need to upsert multiple document URLs into a bot in one request.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"urls\": \"\",\n  \"ability_id\": \"\",\n  \"is_crawled\": false,\n  \"is_sitemap\": false,\n  \"sitemap_id\": \"\",\n  \"sitemap_root\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_create_starter_question",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/starter/question",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "starter",
            "question"
          ]
        },
        "description": "Tool to create a new starter question for the bot. Use when you need to add a preset question-answer pair that users can quickly select.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order\": 0,\n  \"answer\": \"\",\n  \"question\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_delete_starter_question",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/starter/question",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "starter",
            "question"
          ]
        },
        "description": "Deletes a specific starter question from a bot using its unique identifier. This operation is destructive and permanent. First retrieve available starter questions using the Get All Starter Questions ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_delete_uploaded_file",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/uploaded/file",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "uploaded",
            "file"
          ]
        },
        "description": "Delete a specific uploaded file/bot data entry by its unique identifier. This permanently removes the file from the bot's training data. Use this action when you need to clean up outdated content, rem",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_bot_data",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/bot/data",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "bot",
            "data"
          ]
        },
        "description": "Tool to retrieve all data associated with the bot, including files and resources. Use when you need a comprehensive export of bot assets for backup or inspection.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_bots",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/bots",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "bots"
          ]
        },
        "description": "Retrieve all bots associated with your account. Supports pagination, search, and sorting to efficiently manage and query bot configurations. Use this when you need to list, search, or filter existing ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_conversations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/conversations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "conversations"
          ]
        },
        "description": "Tool to retrieve all conversations related to the bot. Use after authentication when you need a paginated list of conversation threads for review or analytics.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\",\n  \"updated_after\": \"\",\n  \"updated_before\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_conversations_with_source",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/conversations/with/source",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "conversations",
            "with",
            "source"
          ]
        },
        "description": "Tool to retrieve all conversations with source information. Use when you need detailed conversation data including source tracking, user form data, and comprehensive metadata for analytics or conversa",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"chat_ids\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\",\n  \"updated_after\": \"\",\n  \"updated_before\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_faqs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/faqs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "faqs"
          ]
        },
        "description": "Retrieve all frequently asked questions (FAQs) associated with your bot in paginated format. Returns a list of FAQ entries with their questions, answers, status, and metadata. Supports filtering by se",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_starter_presets",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/starter/presets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "starter",
            "presets"
          ]
        },
        "description": "Tool to retrieve all starter presets for a bot by bot ID. Use when you need to fetch the bot's welcome message and starter questions configured for user interactions.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_get_all_starter_questions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/starter/questions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "starter",
            "questions"
          ]
        },
        "description": "Tool to retrieve all starter questions. Use after authenticating when you need to list the bot’s opening prompts.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"size\": 0,\n  \"sort_by\": \"\",\n  \"sort_order\": \"\",\n  \"search_query\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botsonic_update_starter_question",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/starter/question",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "starter",
            "question"
          ]
        },
        "description": "Tool to update an existing starter question by its unique identifier. Use after confirming the ID and desired updates.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"order\": 0,\n  \"answer\": \"\",\n  \"question\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}